MCP Integration Guide

Connect your favorite AI agents to Mind Cortex using the Model Context Protocol (MCP). This allows AI assistants to search, read, and create items in your knowledge base.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI applications to securely connect to external data sources and tools. Mind Cortex implements an MCP server that gives AI agents access to your personal knowledge base.

MCP Documentation

Prerequisites

Enable MCP in your Mind Cortex Settings
Copy your MCP Server URL and API Key from the settings page
Install and configure your preferred AI agent (see guides below)

Available MCP Tools

When connected, AI agents can use the following tools:

search_items

Search your knowledge base using semantic or full-text search. Find relevant notes, projects, areas, and resources.

get_item

Retrieve the full content of a specific item by ID.

create_inbox_item

Create a new item in your inbox for later processing.

list_projects

List all your active projects with their status and progress.

list_areas

List all your areas of responsibility.

Claude Desktop

Claude Desktop uses stdio transport, so we need the mcp-remote package to connect to Mind Cortex's remote HTTP server.

1. Install mcp-remote globally:

npm install -g mcp-remote

2. Open your Claude Desktop config file:

# macOS

~/Library/Application Support/Claude/claude_desktop_config.json

# Windows

%APPDATA%\Claude\claude_desktop_config.json

3. Add the Mind Cortex server configuration:

{
  "mcpServers": {
    "mindcortex": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.mindcortex.ai/api/mcp",
        "--header",
        "Authorization: Bearer your-api-key-here"
      ]
    }
  }
}

Replace your-api-key-here with your MCP API key from the Settings page.

4. Restart Claude Desktop

After saving the config, restart Claude Desktop. You should see Mind Cortex listed in the MCP servers when you start a new conversation.

Claude Desktop MCP Guide

Cursor

Cursor IDE supports MCP for enhanced AI assistance. Configure Mind Cortex:

1. Open Cursor Settings

Go to Settings > Features > MCP Servers

2. Add a new MCP server with these settings:

Name: Mind Cortex

URL: https://app.mindcortex.ai/api/mcp

API Key: Your MCP API key from settings

Cursor MCP Documentation

Windsurf (Codeium)

Windsurf supports MCP servers for extended capabilities:

1. Open your Windsurf MCP config:

# macOS

~/.codeium/windsurf/mcp_config.json

# Windows

%USERPROFILE%\.codeium\windsurf\mcp_config.json

2. Add Mind Cortex configuration:

{
  "mcpServers": {
    "mindcortex": {
      "url": "https://app.mindcortex.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

Windsurf MCP Documentation

VS Code with Continue

The Continue extension for VS Code supports MCP servers:

1. Install the Continue extension in VS Code

2. Edit your Continue config (~/.continue/config.json):

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "name": "mindcortex",
        "transport": {
          "type": "sse",
          "url": "https://app.mindcortex.ai/api/mcp"
        },
        "headers": {
          "Authorization": "Bearer your-api-key-here"
        }
      }
    ]
  }
}

Continue MCP Documentation

Claude Code (CLI)

Claude Code CLI supports MCP servers for enhanced context:

Add Mind Cortex as an MCP server:

claude mcp add mindcortex \
  --transport http \
  --url https://app.mindcortex.ai/api/mcp \
  --header "Authorization: Bearer your-api-key-here"

Replace your-api-key-here with your MCP API key from the Settings page.

Claude Code Documentation

Security Considerations

Your API key provides full access to your Mind Cortex data - keep it secure
You can regenerate your API key at any time from the Settings page
Disable MCP access when not in use to prevent unauthorized access
MCP connections are encrypted using HTTPS
Each API request is authenticated and rate-limited

Troubleshooting

Claude Desktop: "command" field required error

Claude Desktop requires stdio transport (using command), not HTTP transport (using url). Make sure you've installed mcp-remote and use the configuration shown in the Claude Desktop section above.

Connection refused or timeout

Ensure MCP is enabled in your Mind Cortex settings and that your API key is correct.

Authentication failed

Regenerate your API key in Settings and update your AI agent configuration.

Tools not appearing

Restart your AI agent after adding the MCP configuration. Check that the config file syntax is valid JSON.

Need Help?

If you encounter issues or have questions about MCP integration, please reach out:

Contact Support GitHub Issues