Back to Docs

MCP Integration Guide

Connect your AI tools to your personal knowledge vault

Requirement: MCP integration is available exclusively for ProAI and Ultra subscribers.

Overview

Model Context Protocol (MCP) allows you to connect external AI tools to your Context Capsule vault. Your capsules become a memory layer that AI assistants can query, making them smarter with your personal knowledge.

Compatible tools include:

Tier Limits

Tier Monthly Requests Storage Price
ProAI 5,000 50 GB $19.99/mo
Ultra 10,000 100 GB $39.99/mo

Limits are request-based only. No data transfer limits through MCP.

Getting Started

1. Generate an API Key

  1. Open Context Capsule app
  2. Go to Profile > MCP Integration
  3. Tap Generate API Key
  4. Name your key (e.g., "Claude Desktop")
  5. Select scopes: read and/or write
  6. Copy your API key immediately - it won't be shown again!

Security: Treat your API key like a password. Never share it publicly or commit it to version control.

2. Configure Your MCP Client

Endpoint:

https://your-domain.replit.app/api/mcp

Authentication: Bearer token

Authorization: Bearer cc_your_api_key_here

Available Tools

list_capsules

List all capsules in your vault.

Parameters: folderId (optional), limit (optional, default 50, max 100)

get_capsule

Get the full content of a specific capsule.

Parameters: capsuleId (required)

search_capsules

Search capsules by keyword.

Parameters: query (required), limit (optional, default 20, max 50)

create_capsule

Create a new capsule. Requires write scope.

Parameters: title (required), content (required), tags (optional), folderId (optional)

list_folders

List all folders in your vault.

Parameters: none

get_vault_summary

Get a summary of your vault including counts and storage usage.

Parameters: none

Example Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_capsules",
    "arguments": {
      "query": "project notes",
      "limit": 10
    }
  }
}

Example Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[{\"id\": \"abc123\", \"title\": \"Project Notes\", ...}]"
      }
    ]
  }
}

Claude Desktop Setup

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "context-capsule": {
      "command": "curl",
      "args": [
        "-X", "POST",
        "-H", "Authorization: Bearer cc_your_api_key",
        "-H", "Content-Type: application/json",
        "https://your-domain.replit.app/api/mcp"
      ]
    }
  }
}

n8n Setup

  1. Add an HTTP Request node
  2. Method: POST
  3. URL: Your MCP endpoint
  4. Authentication: Header Auth
    • Header Name: Authorization
    • Header Value: Bearer cc_your_api_key
  5. Body: JSON with the MCP request

Rate Limiting

Security Best Practices

  1. Never share your API key - Treat it like a password
  2. Use minimal scopes - Only request write if needed
  3. Rotate keys periodically - Create new keys and revoke old ones
  4. Monitor usage - Check your usage regularly
  5. Revoke unused keys - Delete keys you no longer need

Need Help?

Contact our support team at info@1450enterprises.com for MCP integration assistance.