[{"data":1,"prerenderedAt":519},["ShallowReactive",2],{"docs-/docs/guides/ide-agent":3},{"id":4,"title":5,"body":6,"description":511,"extension":512,"meta":513,"navigation":514,"path":515,"seo":516,"stem":517,"__hash__":518},"docs/docs/guides/ide-agent.md","IDE Agent",{"type":7,"value":8,"toc":502},"minimark",[9,14,23,28,34,56,61,68,153,159,230,235,241,248,252,269,273,364,368,404,414,418,425,429,478,482,498],[10,11,13],"h1",{"id":12},"ide-agent-cursor-vs-code","IDE Agent (Cursor / VS Code)",[15,16,17,18,22],"p",{},"The ",[19,20,21],"code",{},"@testflowkit/mcp"," server connects your IDE to the step catalog and project config, so AI-generated tests use only registered sentences.",[24,25,27],"h2",{"id":26},"setup","Setup",[15,29,30],{},[31,32,33],"strong",{},"1. Initialize the project:",[35,36,41],"pre",{"className":37,"code":38,"language":39,"meta":40,"style":40},"language-bash shiki shiki-themes github-light github-dark","tkit init\n","bash","",[19,42,43],{"__ignoreMap":40},[44,45,48,52],"span",{"class":46,"line":47},"line",1,[44,49,51],{"class":50},"sScJk","tkit",[44,53,55],{"class":54},"sZZnC"," init\n",[15,57,58],{},[31,59,60],{},"2. Add MCP config:",[15,62,63,64,67],{},"Cursor (",[19,65,66],{},".cursor/mcp.json","):",[35,69,73],{"className":70,"code":71,"language":72,"meta":40,"style":40},"language-json shiki shiki-themes github-light github-dark","{\n  \"mcpServers\": {\n    \"testflowkit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@testflowkit/mcp\"]\n    }\n  }\n}\n","json",[19,74,75,81,91,99,114,135,141,147],{"__ignoreMap":40},[44,76,77],{"class":46,"line":47},[44,78,80],{"class":79},"sVt8B","{\n",[44,82,84,88],{"class":46,"line":83},2,[44,85,87],{"class":86},"sj4cs","  \"mcpServers\"",[44,89,90],{"class":79},": {\n",[44,92,94,97],{"class":46,"line":93},3,[44,95,96],{"class":86},"    \"testflowkit\"",[44,98,90],{"class":79},[44,100,102,105,108,111],{"class":46,"line":101},4,[44,103,104],{"class":86},"      \"command\"",[44,106,107],{"class":79},": ",[44,109,110],{"class":54},"\"npx\"",[44,112,113],{"class":79},",\n",[44,115,117,120,123,126,129,132],{"class":46,"line":116},5,[44,118,119],{"class":86},"      \"args\"",[44,121,122],{"class":79},": [",[44,124,125],{"class":54},"\"-y\"",[44,127,128],{"class":79},", ",[44,130,131],{"class":54},"\"@testflowkit/mcp\"",[44,133,134],{"class":79},"]\n",[44,136,138],{"class":46,"line":137},6,[44,139,140],{"class":79},"    }\n",[44,142,144],{"class":46,"line":143},7,[44,145,146],{"class":79},"  }\n",[44,148,150],{"class":46,"line":149},8,[44,151,152],{"class":79},"}\n",[15,154,155,156,67],{},"VS Code (",[19,157,158],{},".vscode/mcp.json",[35,160,162],{"className":70,"code":161,"language":72,"meta":40,"style":40},"{\n  \"servers\": {\n    \"testflowkit\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@testflowkit/mcp\"]\n    }\n  }\n}\n",[19,163,164,168,175,181,193,203,217,221,225],{"__ignoreMap":40},[44,165,166],{"class":46,"line":47},[44,167,80],{"class":79},[44,169,170,173],{"class":46,"line":83},[44,171,172],{"class":86},"  \"servers\"",[44,174,90],{"class":79},[44,176,177,179],{"class":46,"line":93},[44,178,96],{"class":86},[44,180,90],{"class":79},[44,182,183,186,188,191],{"class":46,"line":101},[44,184,185],{"class":86},"      \"type\"",[44,187,107],{"class":79},[44,189,190],{"class":54},"\"stdio\"",[44,192,113],{"class":79},[44,194,195,197,199,201],{"class":46,"line":116},[44,196,104],{"class":86},[44,198,107],{"class":79},[44,200,110],{"class":54},[44,202,113],{"class":79},[44,204,205,207,209,211,213,215],{"class":46,"line":137},[44,206,119],{"class":86},[44,208,122],{"class":79},[44,210,125],{"class":54},[44,212,128],{"class":79},[44,214,131],{"class":54},[44,216,134],{"class":79},[44,218,219],{"class":46,"line":143},[44,220,140],{"class":79},[44,222,223],{"class":46,"line":149},[44,224,146],{"class":79},[44,226,228],{"class":46,"line":227},9,[44,229,152],{"class":79},[15,231,232],{},[31,233,234],{},"3. Prompt the agent:",[236,237,238],"blockquote",{},[15,239,240],{},"\"Write a test for user registration using the available API operations.\"",[15,242,243,244,247],{},"The agent reads the step catalog and ",[19,245,246],{},"testflowkit.yml",", then drafts scenarios with valid steps only.",[24,249,251],{"id":250},"requirements","Requirements",[253,254,255,261,264],"ul",{},[256,257,258,260],"li",{},[19,259,51],{}," CLI installed (for catalog version detection)",[256,262,263],{},"Node.js >= 22",[256,265,266,268],{},[19,267,246],{}," in the project root",[24,270,272],{"id":271},"mcp-tools","MCP tools",[274,275,276,289],"table",{},[277,278,279],"thead",{},[280,281,282,286],"tr",{},[283,284,285],"th",{},"Tool",[283,287,288],{},"Purpose",[290,291,292,303,313,323,337,354],"tbody",{},[280,293,294,300],{},[295,296,297],"td",{},[19,298,299],{},"get_step_catalog",[295,301,302],{},"Full sentence list",[280,304,305,310],{},[295,306,307],{},[19,308,309],{},"search_sentences",[295,311,312],{},"Filter by keyword/category",[280,314,315,320],{},[295,316,317],{},[19,318,319],{},"read_test_config",[295,321,322],{},"APIs, pages, elements (secrets redacted)",[280,324,325,334],{},[295,326,327,330,331],{},[19,328,329],{},"list_features"," / ",[19,332,333],{},"read_feature",[295,335,336],{},"Browse feature files",[280,338,339,347],{},[295,340,341,330,344],{},[19,342,343],{},"write_feature",[19,345,346],{},"write_macro",[295,348,349,350,353],{},"Create or update ",[19,351,352],{},".feature"," files",[280,355,356,361],{},[295,357,358],{},[19,359,360],{},"get_guidelines",[295,362,363],{},"Macro and agent authoring docs",[24,365,367],{"id":366},"agent-config-in-testflowkityml","Agent config in testflowkit.yml",[35,369,373],{"className":370,"code":371,"language":372,"meta":40,"style":40},"language-yaml shiki shiki-themes github-light github-dark","agent:\n  default_tags_for_draft: \"@wip @ai-generated\"\n  run_command: \"tkit run --tags @wip\"\n","yaml",[19,374,375,384,394],{"__ignoreMap":40},[44,376,377,381],{"class":46,"line":47},[44,378,380],{"class":379},"s9eBZ","agent",[44,382,383],{"class":79},":\n",[44,385,386,389,391],{"class":46,"line":83},[44,387,388],{"class":379},"  default_tags_for_draft",[44,390,107],{"class":79},[44,392,393],{"class":54},"\"@wip @ai-generated\"\n",[44,395,396,399,401],{"class":46,"line":93},[44,397,398],{"class":379},"  run_command",[44,400,107],{"class":79},[44,402,403],{"class":54},"\"tkit run --tags @wip\"\n",[15,405,17,406,409,410,413],{},[19,407,408],{},"agent:"," block is ignored by ",[19,411,412],{},"tkit run"," — only the MCP server reads it.",[24,415,417],{"id":416},"missing-sentences","Missing sentences",[15,419,420,421,424],{},"If no registered step matches your intent, the agent reports a ",[19,422,423],{},"missing_sentence"," block instead of inventing one. Use these to request new steps via GitHub issues.",[24,426,428],{"id":427},"troubleshooting","Troubleshooting",[274,430,431,441],{},[277,432,433],{},[280,434,435,438],{},[283,436,437],{},"Problem",[283,439,440],{},"Fix",[290,442,443,455,467],{},[280,444,445,448],{},[295,446,447],{},"MCP won't start",[295,449,450,451,454],{},"Run ",[19,452,453],{},"npx @testflowkit/mcp"," manually; check Node >= 22",[280,456,457,460],{},[295,458,459],{},"Catalog empty",[295,461,462,463,466],{},"Verify ",[19,464,465],{},"tkit version"," works",[280,468,469,472],{},[295,470,471],{},"Wrong steps used",[295,473,474,475,477],{},"Ask the agent to call ",[19,476,299],{}," first",[24,479,481],{"id":480},"next-steps","Next Steps",[253,483,484,492],{},[256,485,486,491],{},[487,488,490],"a",{"href":489},"/sentences","Step Catalog"," — Browse all available sentences",[256,493,494,497],{},[487,495,246],{"href":496},"/docs/config/overview"," — Project configuration",[499,500,501],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":40,"searchDepth":83,"depth":83,"links":503},[504,505,506,507,508,509,510],{"id":26,"depth":83,"text":27},{"id":250,"depth":83,"text":251},{"id":271,"depth":83,"text":272},{"id":366,"depth":83,"text":367},{"id":416,"depth":83,"text":417},{"id":427,"depth":83,"text":428},{"id":480,"depth":83,"text":481},"Use the TestFlowKit MCP server to generate tests with Cursor or VS Code Copilot","md",{},{"title":5},"/docs/guides/ide-agent",{"title":5,"description":511},"docs/guides/ide-agent","5Kbfaq7TDnh3t-LK_Ro6dAjbhXqKx7wipkeNx82ikHY",1781768344585]