Chat Connectors let you connect AI chat apps, like ChatGPT, Claude, Cursor, or Le Chat, to your Capacities space.

Overview

By using the 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 developer docs.

Example prompts

1. "Find my notes on the French Revolution in Capacities and create a bullet list of the most relevant historical figures."
2. "Store your last response in my Capacities daily note and add the tags #architecture and #inspiration at the end."
3. "Provide links to all my objects in Capacities that refer to this conversation topic, and organize them by object type."
4. "Review my Capacities objects about Botticelli and compare recurring themes across his paintings in a concise Markdown table."
5. "Gather everything I wrote in Capacities about the recent renovations at La Sagrada Familia and relate them to online sources and news articles."

Setup guide

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.

In the following are instructions for setting up the most popular AI tools.

ChatGPT

1. Access our published ChatGPT connector in the App Directory.
2. Click Connect, and go through the authentication flow to connect to your space.

Claude

1. From the sidebar, open Customize → Connectors
2. Click +, then Add custom connector. Give it a name (Ex: Capacities) and enter the URL:

https://api.capacities.io/mcp

3. Click Connect and go through the authentication flow to connect to your space.

Claude Code

1. Run this command in your terminal:

   claude mcp add --transport http capacities https://api.capacities.io/mcp
   

2. Authenticate by running /mcp in Claude Code and following the authentication flow.
3. Use the /mcp command to list and manage the MCP servers you have installed, and use the /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.

Le Chat (Mistral)

1. Open Intelligence → Connectors
2. Click + Add Connector, then Custom MCP Connector.
3. Specify a name (ex. Capacities), and a description that will help the model contextualize the tools. For example:

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.

4. Enter the URL:

https://api.capacities.io/mcp

Then click on Connect

5. Complete the authentication flow to connect to your space.

Perplexity

1. Go to the Connector settings within Perplexity (link)
2. Click on + Custom connector. Note that this option is only available for paid memberships to Perplexity. Read more here.
3. Specify a name (ex. Capacities), and a description that will help the model contextualize the tools. For example:

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.

4. Enter the URL:

https://api.capacities.io/mcp

5. Click Add, and complete the authentication flow to connect to your space.

LM Studio

1. Navigate to the Developer tab, then click on mcp.json.
2. Paste the following configuration:

{
  "mcpServers": {
    "capacities": {
      "url": "https://api.capacities.io/mcp",
      "auth": {
        "CLIENT_ID": "lm_studio_mcp_capacities_public"
      }
    }
  }
}

3. Click on Save.
4. Next, in the Chats tab, activate the mcp/capacities entry and click on Authenticate, then complete the authentication flow to connect to your space.

Cursor

1. Open Cursor Settings → MCP → Add new global MCP server
2. Paste the following configuration:

   {
     "mcpServers": {
       "capacities": {
         "url": "https://api.capacities.io/mcp",
         "auth": {
           "CLIENT_ID": "cursor_mcp_capacities_public"
         }
       }
     }
   }
   

3. Save and restart Cursor.
4. When you use a Capacities tool for the first time, complete the authentication flow to connect your space.

Visual Studio Code

1. Run the MCP: Add Server... command.
2. Select HTTP as the type of MCP server.
3. Enter https://api.capacities.io/mcp as the server URL.
4. The server ID should be an identifiable name (ex. Capacities).
5. Choose if it should be configured globally for VS Code or just the active workspace.
6. You'll get a pop-up, click Proceed and then use vscode_mcp_capacities_public as the client ID. Leave the secret blank.
7. Another pop-up will take you to the authentication flow to connect your space.

OpenCode

1. Open your configuration file (opencode.json, can be found in ~/.config/opencode).
2. Add the following mcp entry:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "capacities": {
      "type": "remote",
      "url": "https://api.capacities.io/mcp"
    }
  }
}

3. Authenticate by running opencode mcp auth capacities

OpenAI Codex

1. Go to Settings > MCP servers.
2. Click on + Add server.
3. Specify a name (ex. Capacities), and select Streamable HTTP. Then click on Save.
4. Click on Authenticate, and complete the authentication flow to connect to your space.

Google Antigravity

1. Open Cursor Settings → Customizations → Installed MCP Servers
2. Open the MCP Config, then paste the following configuration:

{
  "mcpServers": {
    "oauth-server": {
      "serverUrl": "https://api.capacities.io/mcp"
    }
  }
}

3. Save and refresh the MCP Servers settings. Then click on Authenticate and complete the authentication flow to connect your space. At the end, you'll receive a code.
4. Paste the code in the MCP Servers settings and click Submit.

Android Studio

1. Open Android Studio. Then go to Settings → Tools → AI → MCP Servers.
2. Check Enable MCP Servers, then add the following to your configuration:

{
  "mcpServers": {
    "capacities": {
      "httpUrl": "https://api.capacities.io/mcp"
    }
  }
}

3. After clicking OK, you will see a notification saying "Error connecting to transport: Authorization Exception" with a button that says Start Login.
4. Complete the authentication flow to connect your space.

Other AI tools

You can always configure the Capacities MCP server as a custom MCP client with any tool that supports the MCP protocol, please checkout our Model Context Protocol guide.

Request a new AI chat connector

Missing any other apps we should have an official AI Chat Connector for? Please let us know via our feedback board.

Managing Access

After completing the authentication process for any AI tool, a new entry will appear in Settings > AI Assistant > AI Chat Connectors - Active Connections.

If you'd like to remove access for that tool, simply click on 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.

Privacy

• Access is limited to your selected space: A connected AI tool can only access data from the space you selected during authentication.
• 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.
• Permissions configuration: The connection to MCP will request access to both read and write permissions in your Capacities space. Each tool has a different permissions scope, and many AI applications allow you to prohibit specific tools from a MCP connection. You may check each tool permissions scope here.

Please check our AI Privacy page for details on our privacy with AI features.

FAQs

• Why is my space missing on the AI Chat Connector consent screen?

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.

• Can I connect one AI tool to multiple spaces?

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.

• If I disconnect in Capacities, is it also removed inside ChatGPT, Claude, or Cursor?

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.

Future updates

You should expect more functionality to be delivered for Chat Connectors. You can read about our Roadmap on our MCP Server documentation.