[{"data":1,"prerenderedAt":732},["ShallowReactive",2],{"navigation":3,"/connect-your-tools/mcp-servers":266,"/connect-your-tools/mcp-servers-surround":727},[4,22,50,83,125,166,199,210,236],{"title":5,"path":6,"stem":7,"children":8,"icon":16},"Getting Started","/getting-started","1.getting-started/1.index",[9,12,17],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-ph-house",{"title":13,"path":14,"stem":15,"icon":16},"Quickstart","/getting-started/quickstart","1.getting-started/2.quickstart","i-ph-rocket",{"title":18,"path":19,"stem":20,"icon":21},"Plans","/getting-started/plans","1.getting-started/3.plans","i-ph-credit-card",{"title":23,"path":24,"stem":25,"children":26,"icon":29},"Agents","/agents","2.agents/1.index",[27,30,35,40,45],{"title":28,"path":24,"stem":25,"icon":29},"Overview","i-ph-robot",{"title":31,"path":32,"stem":33,"icon":34},"Creating an agent","/agents/creating-an-agent","2.agents/2.creating-an-agent","i-ph-plus",{"title":36,"path":37,"stem":38,"icon":39},"Agent settings","/agents/settings","2.agents/3.settings","i-ph-gear",{"title":41,"path":42,"stem":43,"icon":44},"Memory","/agents/memory","2.agents/4.memory","i-ph-database",{"title":46,"path":47,"stem":48,"icon":49},"Residential proxy","/agents/proxy","2.agents/5.proxy","i-ph-globe-hemisphere-west",{"title":51,"path":52,"stem":53,"children":54,"icon":57},"Chats & Tasks","/chats-and-tasks","3.chats-and-tasks/1.index",[55,58,63,68,73,78],{"title":56,"path":52,"stem":53,"icon":57},"Chats","i-ph-chats-circle",{"title":59,"path":60,"stem":61,"icon":62},"Sharing chats","/chats-and-tasks/sharing-chats","3.chats-and-tasks/2.sharing-chats","i-ph-share-network",{"title":64,"path":65,"stem":66,"icon":67},"Tasks","/chats-and-tasks/tasks","3.chats-and-tasks/3.tasks","i-ph-list-checks",{"title":69,"path":70,"stem":71,"icon":72},"Recurring tasks","/chats-and-tasks/recurring-tasks","3.chats-and-tasks/4.recurring-tasks","i-ph-repeat",{"title":74,"path":75,"stem":76,"icon":77},"Results & deliverables","/chats-and-tasks/results-and-deliverables","3.chats-and-tasks/5.results-and-deliverables","i-ph-package",{"title":79,"path":80,"stem":81,"icon":82},"Save a chat as a skill","/chats-and-tasks/save-chat-as-skill","3.chats-and-tasks/6.save-chat-as-skill","i-ph-sparkle",{"title":84,"path":85,"stem":86,"children":87,"icon":90},"Models & Skills","/models-and-skills","4.models-and-skills/1.index",[88,91,96,101,105,110,115,120],{"title":89,"path":85,"stem":86,"icon":90},"LLM configuration","i-ph-cpu",{"title":92,"path":93,"stem":94,"icon":95},"Providers & models","/models-and-skills/providers","4.models-and-skills/2.providers","i-ph-stack",{"title":97,"path":98,"stem":99,"icon":100},"Bring your own key","/models-and-skills/byok","4.models-and-skills/3.byok","i-ph-key",{"title":102,"path":103,"stem":104,"icon":29},"ChatGPT subscription","/models-and-skills/chatgpt-subscription","4.models-and-skills/4.chatgpt-subscription",{"title":106,"path":107,"stem":108,"icon":109},"Skills","/models-and-skills/skills","4.models-and-skills/5.skills","i-ph-puzzle-piece",{"title":111,"path":112,"stem":113,"icon":114},"Installing skills","/models-and-skills/installing-skills","4.models-and-skills/6.installing-skills","i-ph-download-simple",{"title":116,"path":117,"stem":118,"icon":119},"Custom skills","/models-and-skills/custom-skills","4.models-and-skills/7.custom-skills","i-ph-code",{"title":121,"path":122,"stem":123,"icon":124},"Local models","/models-and-skills/local-models","4.models-and-skills/8.local-models","i-ph-desktop-tower",{"title":126,"path":127,"stem":128,"children":129,"icon":131},"Connect Your Tools","/connect-your-tools","5.connect-your-tools/1.index",[130,132,137,142,147,152,156,161],{"title":28,"path":127,"stem":128,"icon":131},"i-ph-plug",{"title":133,"path":134,"stem":135,"icon":136},"Telegram","/connect-your-tools/telegram","5.connect-your-tools/2.telegram","i-ph-telegram-logo",{"title":138,"path":139,"stem":140,"icon":141},"Discord","/connect-your-tools/discord","5.connect-your-tools/3.discord","i-ph-discord-logo",{"title":143,"path":144,"stem":145,"icon":146},"Slack","/connect-your-tools/slack","5.connect-your-tools/4.slack","i-ph-slack-logo",{"title":148,"path":149,"stem":150,"icon":151},"Connectors","/connect-your-tools/connectors","5.connect-your-tools/5.connectors","i-ph-link",{"title":153,"path":154,"stem":155,"icon":100},"Secrets","/connect-your-tools/secrets","5.connect-your-tools/6.secrets",{"title":157,"path":158,"stem":159,"icon":160},"Audit log","/connect-your-tools/secret-audit-log","5.connect-your-tools/7.secret-audit-log","i-ph-scroll",{"title":162,"path":163,"stem":164,"icon":165},"MCP servers","/connect-your-tools/mcp-servers","5.connect-your-tools/8.mcp-servers","i-ph-plugs-connected",{"title":167,"path":168,"stem":169,"children":170,"icon":198},"Account & Team","/account-and-team","6.account-and-team/1.index",[171,174,179,184,189,193],{"title":172,"path":168,"stem":169,"icon":173},"Signing in","i-ph-sign-in",{"title":175,"path":176,"stem":177,"icon":178},"Team members","/account-and-team/teams","6.account-and-team/3.teams","i-ph-users",{"title":180,"path":181,"stem":182,"icon":183},"Roles & permissions","/account-and-team/roles-and-permissions","6.account-and-team/4.roles-and-permissions","i-ph-shield",{"title":185,"path":186,"stem":187,"icon":188},"Invitations","/account-and-team/invitations","6.account-and-team/5.invitations","i-ph-envelope-simple",{"title":190,"path":191,"stem":192,"icon":21},"Billing & upgrades","/account-and-team/billing","6.account-and-team/6.billing",{"title":194,"path":195,"stem":196,"icon":197},"Support","/account-and-team/support","6.account-and-team/7.support","i-ph-lifebuoy","i-ph-user",{"title":200,"path":201,"stem":202,"children":203,"icon":205},"Apps","/apps","7.apps/1.index",[204,206],{"title":200,"path":201,"stem":202,"icon":205},"i-ph-squares-four",{"title":207,"path":208,"stem":209,"icon":119},"Building an app","/apps/building-an-app","7.apps/2.building-an-app",{"title":211,"path":212,"stem":213,"children":214,"icon":216},"Workflows","/workflows","8.workflows/1.index",[215,217,221,226,231],{"title":28,"path":212,"stem":213,"icon":216},"i-ph-flow-arrow",{"title":218,"path":219,"stem":220,"icon":82},"Create a workflow","/workflows/creating-a-workflow","8.workflows/2.creating-a-workflow",{"title":222,"path":223,"stem":224,"icon":225},"Edit sections","/workflows/editing-sections","8.workflows/3.editing-sections","i-ph-pencil-simple",{"title":227,"path":228,"stem":229,"icon":230},"Run and schedule","/workflows/running-and-scheduling","8.workflows/4.running-and-scheduling","i-ph-clock",{"title":232,"path":233,"stem":234,"icon":235},"Workflow directory","/workflows/directory","8.workflows/5.directory","i-ph-compass",{"title":237,"path":238,"stem":239,"children":240,"icon":119},"Agent API","/agent-api","9.agent-api/1.index",[241,242,246,251,256,261],{"title":28,"path":238,"stem":239,"icon":119},{"title":13,"path":243,"stem":244,"icon":245},"/agent-api/quickstart","9.agent-api/2.quickstart","i-ph-rocket-launch",{"title":247,"path":248,"stem":249,"icon":250},"Authentication","/agent-api/authentication","9.agent-api/3.authentication","i-ph-lock-key",{"title":252,"path":253,"stem":254,"icon":255},"Endpoints","/agent-api/endpoints","9.agent-api/4.endpoints","i-ph-list-bullets",{"title":257,"path":258,"stem":259,"icon":260},"Streaming","/agent-api/streaming","9.agent-api/5.streaming","i-ph-broadcast",{"title":262,"path":263,"stem":264,"icon":265},"Errors","/agent-api/errors","9.agent-api/6.errors","i-ph-warning-circle",{"id":267,"title":162,"body":268,"description":720,"extension":721,"links":722,"meta":723,"navigation":724,"path":163,"seo":725,"stem":164,"__hash__":726},"docs/5.connect-your-tools/8.mcp-servers.md",{"type":269,"value":270,"toc":707},"minimark",[271,275,284,291,296,303,437,443,458,465,479,483,497,512,515,519,522,556,560,566,572,660,665,679,683,700],[272,273,162],"h1",{"id":274},"mcp-servers",[276,277,278,279,283],"p",{},"The ",[280,281,282],"strong",{},"Model Context Protocol (MCP)"," is an open standard many companies use to offer their\ntools to AI agents. If a service has a remote MCP server — Linear, Notion, Sentry, Stripe,\nAtlassian, Hugging Face, or one your own team runs — you can connect it to your agents in a\nminute.",[276,285,286,287,290],{},"BetterClaw connects to the server for your agents and stores its sign-in or API key encrypted,\nseparately from your ",[288,289,153],"a",{"href":154},". Agents only ever see the server's\ntools, never its credentials.",[292,293,295],"h2",{"id":294},"add-an-mcp-server-from-connectors","Add an MCP server from Connectors",[276,297,298],{},[299,300],"img",{"alt":301,"src":302},"Connectors page with the Add MCP server button, a connected MCP server and the MCP server card","/screenshots/mcp-connectors.png",[304,305,306,325,361,376,382],"ol",{},[307,308,309,310,312,313,316,317,320,321,324],"li",{},"Open ",[280,311,148],{}," and choose ",[280,314,315],{},"Add MCP server"," (or the ",[280,318,319],{},"MCP server"," card under\n",[280,322,323],{},"Browse connectors",").",[307,326,327,328,331,332],{},"In ",[280,329,330],{},"Server URL or mcpServers JSON snippet",", paste one of:\n",[333,334,335,343,354],"ul",{},[307,336,337,338,342],{},"the server's URL — for example ",[339,340,341],"code",{},"https://mcp.linear.app/mcp",";",[307,344,345,346,349,350,353],{},"an ",[339,347,348],{},"mcpServers"," snippet copied from Claude Desktop, Cursor or VS Code. Servers launched\nthrough ",[339,351,352],{},"mcp-remote"," work too, and any header the snippet sets (such as an API key) is used\nautomatically. If the snippet lists several servers, only the first is added;",[307,355,356,357,360],{},"the name of a well-known service, such as ",[339,358,359],{},"Linear",", which fills in its official URL.",[307,362,363,364,367,368,371,372,375],{},"BetterClaw checks the server as soon as you paste and shows what it found below the box: the\n",[280,365,366],{},"server's host"," (with an ",[280,369,370],{},"Official MCP"," badge for well-known services) and, for servers\nthat sign in with OAuth, ",[280,373,374],{},"Signs in with"," and the sign-in host. If that host differs from the\nserver's, only continue if you trust both.",[307,377,278,378,381],{},[280,379,380],{},"Name"," is filled in from the server; you can change it.",[307,383,384,385,388,389],{},"Choose ",[280,386,387],{},"Connect",":\n",[333,390,391,409,431],{},[307,392,393,396,397,400,401,404,405,408],{},[280,394,395],{},"OAuth servers"," open a sign-in window. Approve access and the window closes by itself.\nIf you close it before finishing, the server stays ",[280,398,399],{},"Pending"," and its page shows a\n",[280,402,403],{},"Finish connecting"," banner with a ",[280,406,407],{},"Sign in"," button. OAuth only works with services that\nallow automatic app registration — for others, use an API key.",[307,410,411,414,415,418,419,422,423,426,427,430],{},[280,412,413],{},"API-key servers"," ask for the ",[280,416,417],{},"Header name"," (",[339,420,421],{},"Authorization"," by default) and the\n",[280,424,425],{},"Header value"," — type the whole value the server expects, for example ",[339,428,429],{},"Bearer sk-…",".",[307,432,433,436],{},[280,434,435],{},"Open servers"," connect straight away.",[276,438,439],{},[299,440],{"alt":441,"src":442},"Add MCP server dialog after checking a server","/screenshots/mcp-add-server.png",[276,444,445,446,449,450,453,454,457],{},"BetterClaw gives each server a fixed ",[280,447,448],{},"handle",". Its tools are named after it\n(",[339,451,452],{},"mcp__linear__list_issues",") and workflows refer to it as ",[339,455,456],{},"mcp.linear",". The handle is shown on\nthe server's page.",[276,459,460,461,464],{},"A server added from Connectors is given to ",[280,462,463],{},"every agent you have when it connects",". Agents\nyou create later don't get it automatically — give them access from the server's page. Each MCP\nserver counts as one connector on your plan, whatever its status.",[466,467,468],"note",{},[276,469,470,471,474,475,478],{},"Only ",[280,472,473],{},"remote"," MCP servers (reached by an ",[339,476,477],{},"https://"," URL) are supported. Servers that run\nlocally as a command (stdio) can't be reached from your agents, and neither can addresses on a\nprivate network.",[292,480,482],{"id":481},"add-an-mcp-server-by-chatting","Add an MCP server by chatting",[276,484,485,486,490,491,493,494,496],{},"Ask your agent: ",[487,488,489],"em",{},"\"Connect the Linear MCP server\"",", or paste a URL or ",[339,492,348],{}," snippet into\nthe chat. The agent shows a ",[280,495,387],{}," card. Click it, then sign in — or, if the server needs a\nkey, enter it in the card. Never paste keys into the chat itself. Once it's connected, the agent\ncarries on with what you asked.",[276,498,499,500,503,504,507,508,511],{},"A server connected from chat is available only to ",[280,501,502],{},"the agent you were talking to",". You can\ngive other agents access from the server's page. If the server is already connected but this\nagent can't use it, the card offers ",[280,505,506],{},"Give access"," instead; ",[280,509,510],{},"Dismiss"," drops the request.",[276,513,514],{},"This works in a live chat only — not from scheduled tasks or workflows.",[292,516,518],{"id":517},"using-mcp-tools","Using MCP tools",[276,520,521],{},"Agents call MCP tools on their own whenever a task needs them. A few things to know:",[333,523,524,530,536,546,549],{},[307,525,526,529],{},[280,527,528],{},"Images and files"," a tool returns are saved and shown to you as downloadable files, in the\nchat or on the workflow run. Results larger than 30 MB are refused.",[307,531,532,535],{},[280,533,534],{},"Long results"," are shortened for the model; the full text stays in the agent's workspace.",[307,537,538,541,542,545],{},[280,539,540],{},"Long-running calls"," (up to 24 hours) show in the chat with a running timer and a\n",[280,543,544],{},"Cancel"," button. Cancelling stops that one call; the agent continues its reply.",[307,547,548],{},"A server with more than 15 tools doesn't load them all up front — the agent searches for the\nones it needs.",[307,550,551,552,555],{},"When a well-known service is connected both through its official MCP server and as a regular\nconnector, agents ",[280,553,554],{},"use the MCP server"," for it. The regular connector's page links to the MCP\nserver.",[292,557,559],{"id":558},"managing-a-server","Managing a server",[276,561,562],{},[299,563],{"alt":564,"src":565},"An MCP server's page with its tools and agent access","/screenshots/mcp-server-detail.png",[276,567,568,569,571],{},"Open a server from ",[280,570,148],{}," to:",[333,573,574,601,615,628,634,647,654],{},[307,575,576,577,580,581,584,585,584,587,584,590,593,594,597,598,430],{},"See its ",[280,578,579],{},"status",": ",[280,582,583],{},"Connected",", ",[280,586,399],{},[280,588,589],{},"Needs sign-in",[280,591,592],{},"Unreachable",",\n",[280,595,596],{},"Tools changed"," or ",[280,599,600],{},"Off",[307,602,603,606,607,610,611,614],{},[280,604,605],{},"Turn it off"," for all agents with the switch at the top, ",[280,608,609],{},"rename"," it, or edit its\n",[280,612,613],{},"Description"," — agents read the description to decide when to use the server.",[307,616,617,620,621,597,624,627],{},[280,618,619],{},"Turn individual tools off"," — they're hidden from every agent. Tools are marked\n",[280,622,623],{},"Read-only",[280,625,626],{},"Destructive"," when the server's author says so.",[307,629,630,633],{},[280,631,632],{},"Choose which agents"," can use the server.",[307,635,636,584,639,642,643,646],{},[280,637,638],{},"Refresh tools",[280,640,641],{},"Reconnect"," (OAuth servers) or ",[280,644,645],{},"Update key"," (API-key servers).",[307,648,649,650,653],{},"See ",[280,651,652],{},"activity",": calls and errors in the last 30 days, recent calls, and which workflows use\nthe server.",[307,655,656,659],{},[280,657,658],{},"Remove"," it. If workflows use it, they're listed before you confirm. Agents stop using it\nfrom their next tool call.",[661,662,664],"h3",{"id":663},"when-a-server-changes-its-tools","When a server changes its tools",[276,666,667,668,671,672,675,676,678],{},"If a server adds, removes or changes tools, BetterClaw ",[280,669,670],{},"pauses"," it and shows what changed.\nAgents can't use it until you choose ",[280,673,674],{},"Review & approve",". This protects you from a server\nquietly gaining new abilities. Changes are picked up when you ",[280,677,638],{},", or in the\nbackground while the server is in use.",[292,680,682],{"id":681},"mcp-servers-in-workflows","MCP servers in workflows",[276,684,685,686,689,690,692,693,696,697,699],{},"A workflow section can use an MCP server by listing it in its connectors as\n",[339,687,688],{},"connector:mcp.\u003Chandle>"," — the connector picker lists your connected MCP servers at the top,\nwith an ",[280,691,315],{}," shortcut. A section may only call the MCP servers it lists, and a\n",[280,694,695],{},"dry run"," only calls tools the server marks as read-only. Those labels come from the server's\nauthor, so check them (the ",[280,698,623],{}," badges on the server's tool list) before relying on a\ndry run — and turn off any tool you don't want an agent to run.",[276,701,702,703,706],{},"Before a run starts, BetterClaw checks that every MCP server it needs is connected and available\nto the workflow's agent, so an expired sign-in stops the run up front rather than half-way\nthrough. Files an MCP tool returns during a run appear under ",[280,704,705],{},"Files"," on that section.",{"title":708,"searchDepth":709,"depth":710,"links":711},"",1,2,[712,713,714,715,719],{"id":294,"depth":710,"text":295},{"id":481,"depth":710,"text":482},{"id":517,"depth":710,"text":518},{"id":558,"depth":710,"text":559,"children":716},[717],{"id":663,"depth":718,"text":664},3,{"id":681,"depth":710,"text":682},"Connect any remote MCP server — Linear, Notion, Sentry, Stripe, or your own — to your agents.","md",null,{},{"icon":165},{"title":162,"description":720},"PVYDf9v51Yj_KWKrinQqQCaQ9YWUKSvQ8SSIpnstV5g",[728,730],{"title":157,"path":158,"stem":159,"description":729,"icon":160,"children":-1},"See when and how your secrets were accessed.",{"title":172,"path":168,"stem":169,"description":731,"icon":173,"children":-1},"Create an account or sign in with a one-time email code (OTP).",1791542057669]