[{"data":1,"prerenderedAt":794},["ShallowReactive",2],{"navigation_docs_en":3,"-en-guides-mcp":101,"-en-guides-mcp-surround":789},[4,26,51,84],{"title":5,"path":6,"stem":7,"children":8,"page":25},"Getting Started","/en/getting-started","en/1.getting-started",[9,13,17,21],{"title":10,"path":11,"stem":12},"Introduction","/en/getting-started/introduction","en/1.getting-started/1.introduction",{"title":14,"path":15,"stem":16},"Workspaces","/en/getting-started/workspaces","en/1.getting-started/2.workspaces",{"title":18,"path":19,"stem":20},"Projects","/en/getting-started/projects","en/1.getting-started/3.projects",{"title":22,"path":23,"stem":24},"Quick Start","/en/getting-started/quick-start","en/1.getting-started/quick-start",false,{"title":27,"path":28,"stem":29,"children":30,"page":25},"Features","/en/features","en/2.features",[31,35,39,43,47],{"title":32,"path":33,"stem":34},"Tasks","/en/features/tasks","en/2.features/1.tasks",{"title":36,"path":37,"stem":38},"Targets","/en/features/goals","en/2.features/2.goals",{"title":40,"path":41,"stem":42},"Documents","/en/features/documents","en/2.features/3.documents",{"title":44,"path":45,"stem":46},"Chat","/en/features/chat","en/2.features/4.chat",{"title":48,"path":49,"stem":50},"Inbox","/en/features/inbox","en/2.features/5.inbox",{"title":52,"path":53,"stem":54,"children":55,"page":25},"Guides","/en/guides","en/3.guides",[56,60,64,68,72,76,80],{"title":57,"path":58,"stem":59},"Settings","/en/guides/settings","en/3.guides/1.settings",{"title":61,"path":62,"stem":63},"Admin Panel","/en/guides/admin","en/3.guides/2.admin",{"title":65,"path":66,"stem":67},"Mobile & PWA","/en/guides/mobile","en/3.guides/3.mobile",{"title":69,"path":70,"stem":71},"Tips & Features","/en/guides/tips","en/3.guides/4.tips",{"title":73,"path":74,"stem":75},"Integrations","/en/guides/integrations","en/3.guides/5.integrations",{"title":77,"path":78,"stem":79},"GitHub","/en/guides/github","en/3.guides/6.github",{"title":81,"path":82,"stem":83},"MCP","/en/guides/mcp","en/3.guides/7.mcp",{"title":85,"path":86,"stem":87,"children":88,"page":25},"Reference","/en/reference","en/4.reference",[89,93,97],{"title":90,"path":91,"stem":92},"Pricing & Plans","/en/reference/pricing","en/4.reference/1.pricing",{"title":94,"path":95,"stem":96},"Getting Help","/en/reference/support","en/4.reference/2.support",{"title":98,"path":99,"stem":100},"Permissions & Roles","/en/reference/permissions-roles","en/4.reference/3.permissions-roles",{"id":102,"title":81,"body":103,"description":782,"extension":783,"links":784,"meta":785,"navigation":786,"path":82,"seo":787,"stem":83,"__hash__":788},"docs_en/en/3.guides/7.mcp.md",{"type":104,"value":105,"toc":766},"minimark",[106,111,123,128,157,161,164,168,171,311,314,373,380,383,387,390,504,508,511,516,531,534,554,557,583,586,612,615,641,645,665,669,695,699,702,732,739,743,762],[107,108,110],"h1",{"id":109},"mcp-integration","MCP Integration",[112,113,114,115,122],"p",{},"Connect AI assistants to your Projectyl workspace using the ",[116,117,121],"a",{"href":118,"rel":119},"https://modelcontextprotocol.io",[120],"nofollow","Model Context Protocol (MCP)",". Once connected, your AI assistant can read and create tasks, documents, targets, and more — directly from your editor or terminal.",[124,125,127],"h2",{"id":126},"creating-an-api-token","Creating an API Token",[129,130,131,140,146,149,152],"ol",{},[132,133,134,135,139],"li",{},"Go to ",[136,137,138],"strong",{},"Settings → API Tokens"," tab",[132,141,142,143],{},"Click ",[136,144,145],{},"Create Token",[132,147,148],{},"Enter a name (e.g., \"Claude Code\")",[132,150,151],{},"Select the scopes you need (all are selected by default)",[132,153,142,154],{},[136,155,156],{},"Create",[158,159,160],"note",{},"Your token is shown only once after creation. Copy it immediately — you won't be able to see it again.",[112,162,163],{},"After creation, a ready-to-use MCP configuration snippet is displayed. Copy it into your AI assistant's config file.",[124,165,167],{"id":166},"connecting-your-ai-assistant","Connecting Your AI Assistant",[112,169,170],{},"The configuration snippet shown after token creation looks like this:",[172,173,178],"pre",{"className":174,"code":175,"language":176,"meta":177,"style":177},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"mcpServers\": {\n    \"projectyl\": {\n      \"url\": \"https://projectyl.app/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer pyl_your-token-here\"\n      }\n    }\n  }\n}\n","json","",[179,180,181,190,209,225,251,265,287,293,299,305],"code",{"__ignoreMap":177},[182,183,186],"span",{"class":184,"line":185},"line",1,[182,187,189],{"class":188},"sMK4o","{\n",[182,191,193,196,200,203,206],{"class":184,"line":192},2,[182,194,195],{"class":188},"  \"",[182,197,199],{"class":198},"spNyl","mcpServers",[182,201,202],{"class":188},"\"",[182,204,205],{"class":188},":",[182,207,208],{"class":188}," {\n",[182,210,212,215,219,221,223],{"class":184,"line":211},3,[182,213,214],{"class":188},"    \"",[182,216,218],{"class":217},"sBMFI","projectyl",[182,220,202],{"class":188},[182,222,205],{"class":188},[182,224,208],{"class":188},[182,226,228,231,235,237,239,242,246,248],{"class":184,"line":227},4,[182,229,230],{"class":188},"      \"",[182,232,234],{"class":233},"sbssI","url",[182,236,202],{"class":188},[182,238,205],{"class":188},[182,240,241],{"class":188}," \"",[182,243,245],{"class":244},"sfazB","https://projectyl.app/api/mcp",[182,247,202],{"class":188},[182,249,250],{"class":188},",\n",[182,252,254,256,259,261,263],{"class":184,"line":253},5,[182,255,230],{"class":188},[182,257,258],{"class":233},"headers",[182,260,202],{"class":188},[182,262,205],{"class":188},[182,264,208],{"class":188},[182,266,268,271,275,277,279,281,284],{"class":184,"line":267},6,[182,269,270],{"class":188},"        \"",[182,272,274],{"class":273},"swJcz","Authorization",[182,276,202],{"class":188},[182,278,205],{"class":188},[182,280,241],{"class":188},[182,282,283],{"class":244},"Bearer pyl_your-token-here",[182,285,286],{"class":188},"\"\n",[182,288,290],{"class":184,"line":289},7,[182,291,292],{"class":188},"      }\n",[182,294,296],{"class":184,"line":295},8,[182,297,298],{"class":188},"    }\n",[182,300,302],{"class":184,"line":301},9,[182,303,304],{"class":188},"  }\n",[182,306,308],{"class":184,"line":307},10,[182,309,310],{"class":188},"}\n",[112,312,313],{},"Where to paste this depends on your AI assistant:",[315,316,317,330],"table",{},[318,319,320],"thead",{},[321,322,323,327],"tr",{},[324,325,326],"th",{},"Assistant",[324,328,329],{},"Config Location",[331,332,333,350,360],"tbody",{},[321,334,335,341],{},[336,337,338],"td",{},[136,339,340],{},"Claude Code",[336,342,343,346,347],{},[179,344,345],{},"~/.claude.json"," or project-level ",[179,348,349],{},".mcp.json",[321,351,352,357],{},[336,353,354],{},[136,355,356],{},"Cursor",[336,358,359],{},"Settings → MCP Servers",[321,361,362,367],{},[336,363,364],{},[136,365,366],{},"VS Code (Copilot)",[336,368,369,372],{},[179,370,371],{},".vscode/mcp.json"," in your project",[158,374,375,376,379],{},"Your token is a secret. Do not commit MCP config files containing tokens to version control. Use environment variables or add the config file to ",[179,377,378],{},".gitignore",".",[112,381,382],{},"After adding the config, restart your assistant or reload the MCP server list.",[124,384,386],{"id":385},"available-scopes","Available Scopes",[112,388,389],{},"Scopes control what your AI assistant can do. Choose only what you need.",[315,391,392,402],{},[318,393,394],{},[321,395,396,399],{},[324,397,398],{},"Scope",[324,400,401],{},"Description",[331,403,404,414,424,434,444,454,464,474,484,494],{},[321,405,406,411],{},[336,407,408],{},[179,409,410],{},"tasks:read",[336,412,413],{},"List and view tasks",[321,415,416,421],{},[336,417,418],{},[179,419,420],{},"tasks:create",[336,422,423],{},"Create new tasks",[321,425,426,431],{},[336,427,428],{},[179,429,430],{},"tasks:update",[336,432,433],{},"Update existing tasks",[321,435,436,441],{},[336,437,438],{},[179,439,440],{},"docs:read",[336,442,443],{},"List and view documents",[321,445,446,451],{},[336,447,448],{},[179,449,450],{},"docs:create",[336,452,453],{},"Create new documents",[321,455,456,461],{},[336,457,458],{},[179,459,460],{},"docs:update",[336,462,463],{},"Update existing documents",[321,465,466,471],{},[336,467,468],{},[179,469,470],{},"projects:read",[336,472,473],{},"List and view projects",[321,475,476,481],{},[336,477,478],{},[179,479,480],{},"goals:read",[336,482,483],{},"List and view targets",[321,485,486,491],{},[336,487,488],{},[179,489,490],{},"goals:create",[336,492,493],{},"Create new targets",[321,495,496,501],{},[336,497,498],{},[179,499,500],{},"goals:update",[336,502,503],{},"Update existing targets",[124,505,507],{"id":506},"available-tools","Available Tools",[112,509,510],{},"Once connected, your AI assistant has access to these tools:",[512,513,515],"h3",{"id":514},"workspace","Workspace",[517,518,519,525],"ul",{},[132,520,521,524],{},[136,522,523],{},"whoami"," — Check the current user and token info",[132,526,527,530],{},[136,528,529],{},"get_workspace_info"," — View workspace details",[512,532,18],{"id":533},"projects",[517,535,536,542,548],{},[132,537,538,541],{},[136,539,540],{},"list_projects"," — List all accessible projects",[132,543,544,547],{},[136,545,546],{},"get_project"," — View project details",[132,549,550,553],{},[136,551,552],{},"list_project_members"," — View project members and roles",[512,555,32],{"id":556},"tasks",[517,558,559,565,571,577],{},[132,560,561,564],{},[136,562,563],{},"list_tasks"," — List tasks with filtering and pagination",[132,566,567,570],{},[136,568,569],{},"get_task"," — View a task with all relations",[132,572,573,576],{},[136,574,575],{},"create_task"," — Create a new task",[132,578,579,582],{},[136,580,581],{},"update_task"," — Update a task",[512,584,40],{"id":585},"documents",[517,587,588,594,600,606],{},[132,589,590,593],{},[136,591,592],{},"list_documents"," — List documents with search and pagination",[132,595,596,599],{},[136,597,598],{},"get_document"," — View a document including its full content",[132,601,602,605],{},[136,603,604],{},"create_document"," — Create a new document",[132,607,608,611],{},[136,609,610],{},"update_document"," — Update a document",[512,613,36],{"id":614},"targets",[517,616,617,623,629,635],{},[132,618,619,622],{},[136,620,621],{},"list_targets"," — List targets with optional filters",[132,624,625,628],{},[136,626,627],{},"get_target"," — View a target with full details",[132,630,631,634],{},[136,632,633],{},"create_target"," — Create a new target",[132,636,637,640],{},[136,638,639],{},"update_target"," — Update a target",[512,642,644],{"id":643},"dependencies","Dependencies",[517,646,647,653,659],{},[132,648,649,652],{},[136,650,651],{},"list_task_dependencies"," — View a task's predecessors and successors",[132,654,655,658],{},[136,656,657],{},"create_task_dependency"," — Create a dependency between two tasks",[132,660,661,664],{},[136,662,663],{},"delete_task_dependency"," — Remove a dependency",[512,666,668],{"id":667},"other","Other",[517,670,671,677,683,689],{},[132,672,673,676],{},[136,674,675],{},"list_comments"," — View comments on a task or document",[132,678,679,682],{},[136,680,681],{},"list_states"," — View workflow states for a project",[132,684,685,688],{},[136,686,687],{},"list_labels"," — View labels for a project",[132,690,691,694],{},[136,692,693],{},"get_help"," — Get usage guidance for the MCP tools",[124,696,698],{"id":697},"rate-limits","Rate Limits",[112,700,701],{},"To ensure fair usage, MCP requests are rate-limited:",[315,703,704,714],{},[318,705,706],{},[321,707,708,711],{},[324,709,710],{},"Limit",[324,712,713],{},"Threshold",[331,715,716,724],{},[321,717,718,721],{},[336,719,720],{},"Per API token",[336,722,723],{},"60 requests / minute",[321,725,726,729],{},[336,727,728],{},"Per workspace (all tokens combined)",[336,730,731],{},"300 requests / minute",[112,733,734,735,738],{},"If you hit a rate limit, you'll receive an HTTP 429 response with a ",[179,736,737],{},"Retry-After"," header indicating when to retry.",[124,740,742],{"id":741},"managing-tokens","Managing Tokens",[517,744,745,751,756,759],{},[132,746,747,748],{},"Each user can have ",[136,749,750],{},"one token per workspace",[132,752,753,754],{},"Tokens can be revoked at any time from ",[136,755,138],{},[132,757,758],{},"Revoking a token immediately disconnects any MCP clients using it",[132,760,761],{},"To rotate a token, revoke the existing one and create a new one",[763,764,765],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}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);}",{"title":177,"searchDepth":192,"depth":192,"links":767},[768,769,770,771,780,781],{"id":126,"depth":192,"text":127},{"id":166,"depth":192,"text":167},{"id":385,"depth":192,"text":386},{"id":506,"depth":192,"text":507,"children":772},[773,774,775,776,777,778,779],{"id":514,"depth":211,"text":515},{"id":533,"depth":211,"text":18},{"id":556,"depth":211,"text":32},{"id":585,"depth":211,"text":40},{"id":614,"depth":211,"text":36},{"id":643,"depth":211,"text":644},{"id":667,"depth":211,"text":668},{"id":697,"depth":192,"text":698},{"id":741,"depth":192,"text":742},"Connect AI assistants like Claude Code and Cursor to your workspace using the Model Context Protocol.","md",null,{},true,{"title":81,"description":782},"tolpyWVTV_WOmjKrDeegXDawp6R3rHBRGGGqKHqfm_Y",[790,792],{"title":77,"path":78,"stem":79,"description":791,"children":-1},"Connect GitHub to create branches from tasks and automatically track pull requests.",{"title":90,"path":91,"stem":92,"description":793,"children":-1},"Compare Projectyl plans and features.",1776307257206]