> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Connect Craft with AI assistants and developer tools using the Model Context Protocol.

Connect AI assistants and developer tools to your Craft content through MCP (Model Context Protocol).

## What is MCP?

MCP (Model Context Protocol) is a standard that allows external applications to connect to a specific source of information. In Craft, MCP gives these tools controlled access to your selected content so they can read, process, and work with it safely.

With MCP enabled, external tools can:

* Read the content of your Craft documents
* Generate summaries, insights, or transformations
* Assist you with writing or restructuring content
* Use your documents as a live knowledge source
* Search across your selected documents

## How MCP Works in Craft

Create an **MCP Connection** from the **Connections tab** in the sidebar to share the right parts of your workspace with external tools.

You can choose between:

* Creating an MCP connection that includes **all your daily notes**, or
* Setting up a **custom connection** where you pick specific documents (one or more) to include

Each connection lets you define access permissions and visibility, so you stay in control of what's shared. Once created, Craft automatically generates a **unique MCP endpoint** for that connection. You can then add this endpoint to any MCP-compatible tool to connect it securely to your chosen documents – keeping everything else in your workspace private.

<Frame>
  <img src="https://mintcdn.com/craft-support/MJS4Hvk12NRdLmWK/images/integrate/mcp/en/content/connections-page.png?fit=max&auto=format&n=MJS4Hvk12NRdLmWK&q=85&s=dbf65cbb7cc5de538b5da7b8e3801f20" alt="The Connections tab in the sidebar, showing the MCP and API connection sections" width="1568" height="950" data-path="images/integrate/mcp/en/content/connections-page.png" />
</Frame>

<Info title="Full Space API Access (v3.3.5+)">
  A connection with **full space-level access** supports:

  * **Search across all documents** with tag and date filtering
  * **Daily notes and tasks** are fully accessible via MCP
  * **Create, update, and delete** documents programmatically
  * **Collection management** including schema creation and editing
  * **Advanced search** with regex support and timezone-aware date filters

  See the [official MCP documentation](https://www.craft.do/imagine/) for complete details.
</Info>

## Use Craft with ChatGPT

Use the Craft plugin to search your notes, summarize documents, and create or update content from ChatGPT.

1. Open the [Craft plugin page](https://chatgpt.com/plugins/plugin_asdk_app_6973544cd0908191b63b0f566a23edb7) and select **Install plugin**.
2. Follow the connection prompts and sign in to Craft if asked.
3. Review the requested access and complete authorization.

After connecting, mention Craft with `@` or select it from the chat tools menu. For example, ask: “Find my notes about onboarding and summarize the open questions.”

ChatGPT can access the content you authorize. You can manage or disconnect the connection in ChatGPT's **Apps** or **Plugins** settings.

<Info title="Availability">
  If Craft is unavailable, check the message on its plugin page. If access is disabled by an administrator, ask your workspace administrator to enable it.
</Info>

## Connect another MCP-compatible tool

For other MCP-compatible tools, create an MCP connection in Craft, copy the generated MCP link or credentials from the Connections tab, then add them in the external tool's MCP or connector settings. The tool can access only the notes or documents included in that connection, based on the permissions you set.

## Supported MCP Connections

Craft currently supports MCP integrations with:

* **Claude** (Desktop and Claude Code)
* **ChatGPT** (through the Craft plugin)
* **Windsurf**
* **Cursor**
* **Visual Studio Code**
* **Raycast**
* **Other standard MCP clients**

These tools can connect directly to your Craft documents to read and assist you with their content.

## What You Can Do With MCP

With MCP enabled, you can:

* Ask AI assistants to analyze or summarize your documents
* Generate or rewrite content based on your Craft documents
* Use developer tools to build custom workflows or scripts using your Craft content
* Interact with your documents from coding environments like VS Code, Cursor, or Windsurf
* Search and filter documents programmatically
* Extend Craft with your own MCP-compatible tools or automations

## Using MCP with Multiple Spaces

**ChatGPT plugin:** You can connect multiple Craft spaces. Open the [Craft plugin page](https://chatgpt.com/plugins/plugin_asdk_app_6973544cd0908191b63b0f566a23edb7) in ChatGPT and, under **Connected accounts**, select **Connect another account**. In the Craft authorization flow, sign in if prompted, select the additional space, and approve access. Repeat for each space you want to add. Despite the button's name, you can select another space from the same Craft account.

**Manual MCP connections:** Each connection is linked to a single space. Create a separate MCP connection for each space you want to add:

<Steps>
  <Step>
    Open the space you want to connect
  </Step>

  <Step>
    Go to the **Connections tab** in the sidebar and create an MCP connection for that space
  </Step>

  <Step>
    Copy the MCP endpoint and add it to your external tool as a separate MCP server
  </Step>

  <Step>
    Repeat for each additional space you want to connect
  </Step>
</Steps>

<Info title="One connector per space">
  For manual MCP connections, add each space's link separately in your external tool.
</Info>

## Full Guides & Documentation

All setup instructions and integration guides are available at:

👉 [**https://www.craft.do/imagine/**](https://www.craft.do/imagine/)

For the ChatGPT plugin, follow [Use Craft with ChatGPT](#use-craft-with-chatgpt). The developer documentation covers manual MCP connections and other integrations.

## Troubleshooting

For a manual MCP connection that stops working, try the following steps. For the ChatGPT plugin, review the connection in ChatGPT's **Apps** or **Plugins** settings and reconnect if prompted.

<Steps>
  <Step title="Reconnect">
    Try disconnecting and reconnecting the MCP server in your client app.
  </Step>

  <Step title="Recreate the connector">
    If reconnecting didn't help, remove the MCP connector from your client app and set it up again using the same link.
  </Step>

  <Step title="Recreate the link in Craft">
    If the issue persists, delete the MCP connection in Craft's Connections tab and create a new one. Then add the new link to your client app.
  </Step>
</Steps>

<Info>
  Some MCP clients ship updates very frequently, which can occasionally break existing connections. These steps resolve most issues, though in rare cases you may need to wait for a fix from the client app.
</Info>

<CardGroup cols={2}>
  <Card title="MCP Security" href="/en/integrate/mcp/security">
    Learn about MCP security features and access controls
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.