[{"data":1,"prerenderedAt":649},["ShallowReactive",2],{"/reference/ai-chat-connectors":3,"/reference/ai-chat-connectors-surround":639},{"id":4,"title":5,"body":6,"description":628,"extension":629,"links":630,"meta":631,"navigation":633,"path":635,"seo":636,"stem":637,"__hash__":638},"docs/2.reference/ai-chat-connectors.md","AI Chat Connectors",{"type":7,"value":8,"toc":619},"minimark",[9,12,20,23,28,44,49,79,83,86,93,99,106,109,113,120,155,165,171,177,183,187,192,213,218,227,231,287,291,312,317,321,326,331,335,339,485,489,496,500,508,512,518,525,531,535,551,559,563,590,594,600,615],[10,11],"capacities-pro-label",{},[13,14,16],"tip",{"title":15},"Chat Connectors Beta",[17,18,19],"p",{},"AI Chat Connectors are in Beta at the moment. They are an early version and are subject to change. You can expect more functionality to be added over time.",[17,21,22],{},"Chat Connectors let you connect AI chat apps, like ChatGPT, Claude, Cursor, or Le Chat, to your Capacities space.",[24,25,27],"h2",{"id":26},"overview","Overview",[17,29,30,31,38,39,43],{},"By using the ",[32,33,37],"a",{"href":34,"rel":35},"https://modelcontextprotocol.io/docs/getting-started/intro",[36],"nofollow","Model Context Protocol (MCP)"," open standard, you can connect your Capacities space to allow access to your AI assistant of choice so that it may search, read objects, add content to your daily note and link objects in its responses. You can view all capabilities in detail in our ",[32,40,42],{"href":41},"/developer/model-context-protocol#available-tools","developer docs",".",[45,46,48],"h4",{"id":47},"example-prompts","Example prompts",[50,51,52,59,64,69,74],"ol",{},[53,54,55],"li",{},[56,57,58],"em",{},"\"Find my notes on the French Revolution in Capacities and create a bullet list of the most relevant historical figures.\"",[53,60,61],{},[56,62,63],{},"\"Store your last response in my Capacities daily note and add the tags #architecture and #inspiration at the end.\"",[53,65,66],{},[56,67,68],{},"\"Provide links to all my objects in Capacities that refer to this conversation topic, and organize them by object type.\"",[53,70,71],{},[56,72,73],{},"\"Review my Capacities objects about Botticelli and compare recurring themes across his paintings in a concise Markdown table.\"",[53,75,76],{},[56,77,78],{},"\"Gather everything I wrote in Capacities about the recent renovations at La Sagrada Familia and relate them to online sources and news articles.\"",[24,80,82],{"id":81},"setup-guide","Setup guide",[17,84,85],{},"In the setup process you'll give the tool of your choice access to a selected Capacities space. The AI can then interact with Capacities on your behalf.",[17,87,88],{},[89,90],"img",{"alt":91,"src":92},"oauth-consent","/reference/media/oauth-consent.png",[13,94,96],{"title":95},"Working with multiple spaces",[17,97,98],{},"Only the space that you select in this consent screen is the one that the tool will be able to access for that particular connection. If you would like to use multiple spaces from the same AI tool, you'll have to setup multiple MCP connections.",[100,101,103],"note",{"title":102},"Space missing in the consent list?",[17,104,105],{},"If you don't see a space in the consent screen, AI Assistant is not enabled for that space yet. Only spaces with AI Assistant enabled are shown and can be connected through MCP.",[17,107,108],{},"In the following are instructions for setting up the most popular AI tools.",[45,110,112],{"id":111},"chatgpt","ChatGPT",[114,115,117],"warning",{"title":116},"Connector under review",[17,118,119],{},"We have applied to add our connector as a public option in OpenAI's app catalogue for easier setup. Until then, if you want to utilize ChatGPT you'll have to enable Developer Mode and add the MCP server URL directly. To do so:",[50,121,122,131,144],{},[53,123,124,125,130],{},"Go to the Apps settings within ChatGPT (",[32,126,129],{"href":127,"rel":128},"https://chatgpt.com/#settings/Connectors",[36],"link",")",[53,132,133,134,138,139,43],{},"Click on ",[135,136,137],"code",{},"Advanced Settings",", and enable Developer mode. Note that this option is only available for ChatGPT's Pro, Plus, Business, Enterprise and Education accounts on the web. Read more ",[32,140,143],{"href":141,"rel":142},"https://developers.openai.com/api/docs/guides/developer-mode",[36],"here",[53,145,146,147,150,151,154],{},"Click ",[135,148,149],{},"Add App",". Specify a name (ex. ",[135,152,153],{},"Capacities","), and a description that will help the model contextualize the tools. For example:",[156,157,163],"pre",{"className":158,"code":160,"language":161,"meta":162},[159],"language-text","Capacities brings together connected note-taking and structured data so everything you care about becomes an object, whether it’s a person, a book you’re reading, a project you’re working on or an idea you want to explore. Objects have structure, properties and connections that grow into a living network of your thoughts.\n","text","",[135,164,160],{"__ignoreMap":162},[50,166,168],{"start":167},4,[53,169,170],{},"Enter the URL:",[156,172,175],{"className":173,"code":174,"language":161,"meta":162},[159],"https://api.capacities.io/mcp\n",[135,176,174],{"__ignoreMap":162},[50,178,180],{"start":179},5,[53,181,182],{},"Complete the authentication flow to connect to your space.",[45,184,186],{"id":185},"claude","Claude",[114,188,189],{"title":116},[17,190,191],{},"We have applied to add our connector as a public option in Claude's connector catalogue for easier setup. Until then, if you want to utilize Claude you'll have to add the MCP server URL directly. To do so:",[50,193,194,200],{},[53,195,196,197],{},"From the sidebar, open ",[135,198,199],{},"Customize → Connectors",[53,201,146,202,205,206,209,210,212],{},[135,203,204],{},"+",", then ",[135,207,208],{},"Add custom connector",". Give it a name (Ex: ",[56,211,153],{},") and enter the URL:",[156,214,216],{"className":215,"code":174,"language":161,"meta":162},[159],[135,217,174],{"__ignoreMap":162},[50,219,221],{"start":220},3,[53,222,146,223,226],{},[135,224,225],{},"Connect"," and go through the authentication flow to connect to your space.",[45,228,230],{"id":229},"claude-code","Claude Code",[50,232,233,270,277],{},[53,234,235,236],{},"Run this command in your terminal:",[156,237,241],{"className":238,"code":239,"language":240,"meta":162,"style":162},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","claude mcp add --transport http capacities https://api.capacities.io/mcp\n","bash",[135,242,243],{"__ignoreMap":162},[244,245,248,251,255,258,261,264,267],"span",{"class":246,"line":247},"line",1,[244,249,185],{"class":250},"sBMFI",[244,252,254],{"class":253},"sfazB"," mcp",[244,256,257],{"class":253}," add",[244,259,260],{"class":253}," --transport",[244,262,263],{"class":253}," http",[244,265,266],{"class":253}," capacities",[244,268,269],{"class":253}," https://api.capacities.io/mcp\n",[53,271,272,273,276],{},"Authenticate by running ",[135,274,275],{},"/mcp"," in Claude Code and following the authentication flow.",[53,278,279,280,282,283,286],{},"Use the ",[135,281,275],{}," command to list and manage the MCP servers you have installed, and use the ",[135,284,285],{},"/context"," command to understand the context token usage of your current session, including the number of tokens used by each MCP server that’s enabled.",[45,288,290],{"id":289},"le-chat-mistral","Le Chat (Mistral)",[50,292,293,299,307],{},[53,294,295,296],{},"Open ",[135,297,298],{},"Intelligence → Connectors",[53,300,146,301,205,304,43],{},[135,302,303],{},"+ Add Connector",[135,305,306],{},"Custom MCP Connector",[53,308,309,310,154],{},"Specify a name (ex. ",[135,311,153],{},[156,313,315],{"className":314,"code":160,"language":161,"meta":162},[159],[135,316,160],{"__ignoreMap":162},[50,318,319],{"start":167},[53,320,170],{},[156,322,324],{"className":323,"code":174,"language":161,"meta":162},[159],[135,325,174],{"__ignoreMap":162},[17,327,328,329],{},"Then click on ",[135,330,225],{},[50,332,333],{"start":179},[53,334,182],{},[45,336,338],{"id":337},"cursor","Cursor",[50,340,341,347,479,482],{},[53,342,343,344],{},"Open Cursor ",[135,345,346],{},"Settings → MCP → Add new global MCP server",[53,348,349,350],{},"Paste the following configuration:",[156,351,355],{"className":352,"code":353,"language":354,"meta":162,"style":162},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n    \"mcpServers\": {\n        \"capacities\": {\n            \"url\": \"https://api.capacities.io/mcp\",\n            \"auth\": {\n                \"CLIENT_ID\": \"cursor_mcp_capacities_public\"\n            }\n        }\n    }\n}\n","json",[135,356,357,363,382,396,420,433,455,461,467,473],{"__ignoreMap":162},[244,358,359],{"class":246,"line":247},[244,360,362],{"class":361},"sMK4o","{\n",[244,364,366,369,373,376,379],{"class":246,"line":365},2,[244,367,368],{"class":361},"    \"",[244,370,372],{"class":371},"spNyl","mcpServers",[244,374,375],{"class":361},"\"",[244,377,378],{"class":361},":",[244,380,381],{"class":361}," {\n",[244,383,384,387,390,392,394],{"class":246,"line":220},[244,385,386],{"class":361},"        \"",[244,388,389],{"class":250},"capacities",[244,391,375],{"class":361},[244,393,378],{"class":361},[244,395,381],{"class":361},[244,397,398,401,405,407,409,412,415,417],{"class":246,"line":167},[244,399,400],{"class":361},"            \"",[244,402,404],{"class":403},"sbssI","url",[244,406,375],{"class":361},[244,408,378],{"class":361},[244,410,411],{"class":361}," \"",[244,413,414],{"class":253},"https://api.capacities.io/mcp",[244,416,375],{"class":361},[244,418,419],{"class":361},",\n",[244,421,422,424,427,429,431],{"class":246,"line":179},[244,423,400],{"class":361},[244,425,426],{"class":403},"auth",[244,428,375],{"class":361},[244,430,378],{"class":361},[244,432,381],{"class":361},[244,434,436,439,443,445,447,449,452],{"class":246,"line":435},6,[244,437,438],{"class":361},"                \"",[244,440,442],{"class":441},"swJcz","CLIENT_ID",[244,444,375],{"class":361},[244,446,378],{"class":361},[244,448,411],{"class":361},[244,450,451],{"class":253},"cursor_mcp_capacities_public",[244,453,454],{"class":361},"\"\n",[244,456,458],{"class":246,"line":457},7,[244,459,460],{"class":361},"            }\n",[244,462,464],{"class":246,"line":463},8,[244,465,466],{"class":361},"        }\n",[244,468,470],{"class":246,"line":469},9,[244,471,472],{"class":361},"    }\n",[244,474,476],{"class":246,"line":475},10,[244,477,478],{"class":361},"}\n",[53,480,481],{},"Save and restart Cursor.",[53,483,484],{},"When you use a Capacities tool for the first time, complete the authentication flow to connect your space.",[45,486,488],{"id":487},"other-ai-tools","Other AI tools",[17,490,491,492,43],{},"You can always configure the Capacities MCP server as a custom MCP client with any tool that supports the MCP protocol, please checkout our ",[32,493,495],{"href":494},"/developer/model-context-protocol","Model Context Protocol guide",[24,497,499],{"id":498},"request-a-new-ai-chat-connector","Request a new AI chat connector",[17,501,502,503,43],{},"Missing any other apps we should have an official AI Chat Connector for? Please let us know via our ",[32,504,507],{"href":505,"rel":506},"https://feedback.capacities.io",[36],"feedback board",[24,509,511],{"id":510},"managing-access","Managing Access",[17,513,514,515,43],{},"After completing the authentication process for any AI tool, a new entry will appear in ",[135,516,517],{},"Settings > AI Assistant > AI Chat Connectors - Active Connections",[17,519,520,521,524],{},"If you'd like to remove access for that tool, simply click on ",[56,522,523],{},"Disconnect"," on its entry. Note that this doesn't automatically remove it from the tool's connections. Likewise, removing the Connector from your AI tool won't automatically remove its access rights from Capacities.",[17,526,527],{},[89,528],{"alt":529,"src":530},"active-ai-connections","/reference/media/active-ai-connections.png",[24,532,534],{"id":533},"privacy","Privacy",[536,537,538,545],"ul",{},[53,539,540,544],{},[541,542,543],"strong",{},"Access is limited to your selected space",": A connected AI tool can only access data from the space you selected during authentication.",[53,546,547,550],{},[541,548,549],{},"Privacy policy of the connected AI tool applies",": When utilizing external AI tools with Capacities, your settings for the connected AI tool will determine what privacy policy applies on the data that's obtained by the AI model by using the Capacities connection. If you're concerned about that tool using your data to train new models or sharing it with third parties, make sure to read that AI tool's privacy policy and configure the tool according to your preferences.",[17,552,553,554,558],{},"Please check our ",[32,555,557],{"href":556},"/more/ai-privacy","AI Privacy"," page for details on our privacy with AI features.",[24,560,562],{"id":561},"faqs","FAQs",[536,564,565,574,582],{},[53,566,567,570,573],{},[541,568,569],{},"Why is my space missing on the AI Chat Connector consent screen?",[571,572],"br",{},"If a space does not appear in the consent list during authentication, AI Assistant is not enabled for that space. Only spaces with AI Assistant enabled are shown and can be connected through MCP.",[53,575,576,579,581],{},[541,577,578],{},"Can I connect one AI tool to multiple spaces?",[571,580],{},"Yes, but each connection is scoped to one space. To use multiple spaces in the same AI tool, create separate MCP connections and authorize each space individually.",[53,583,584,587,589],{},[541,585,586],{},"If I disconnect in Capacities, is it also removed inside ChatGPT, Claude, or Cursor?",[571,588],{},"No. Disconnecting in Capacities removes access rights on the Capacities side, but it does not automatically delete the connector entry in the AI tool. You may want to remove it there as well.",[24,591,593],{"id":592},"future-updates","Future updates",[17,595,596,597,43],{},"You should expect more functionality to be delivered for Chat Connectors. You can read about our Roadmap on our ",[32,598,599],{"href":494},"MCP Server documentation",[100,601,603],{"title":602},"Building your own AI app or bot?",[17,604,605,606,609,610,614],{},"If you’re implementing a ",[541,607,608],{},"custom MCP client"," (OAuth 2.1, PKCE, token refresh) to integrate Capacities into your own app/agent/bot, please refer to ",[541,611,612],{},[32,613,37],{"href":494}," instead.",[616,617,618],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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);}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 .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":162,"searchDepth":247,"depth":365,"links":620},[621,622,623,624,625,626,627],{"id":26,"depth":365,"text":27},{"id":81,"depth":365,"text":82},{"id":498,"depth":365,"text":499},{"id":510,"depth":365,"text":511},{"id":533,"depth":365,"text":534},{"id":561,"depth":365,"text":562},{"id":592,"depth":365,"text":593},"Learn how to connect the Capacities AI Assistant to your favorite AI Chat apps.","md",null,{"image":632},"/reference/media/ai-assistant-cover.jpg",{"icon":634},"i-ph-plugs-connecte","/reference/ai-chat-connectors",{"title":5,"description":628},"2.reference/ai-chat-connectors","JAkFMnr2XeVjknYarcnV7ltfEYpHwlnr1dljXB_3reQ",[640,645],{"title":641,"path":642,"stem":643,"icon":644,"children":-1},"AI Assistant","/reference/ai-assistant","2.reference/ai-assistant","i-ph-sparkle",{"title":646,"path":647,"stem":648,"children":-1},"AI Roadmap","/reference/ai-roadmap","2.reference/ai-roadmap",1776250803260]