Claude Desktop Integration

Connect your Knowledge AI project to Claude Desktop using MCP (Model Context Protocol) for seamless access to your knowledge base directly in Claude.

🚀 Overview

The Claude Desktop integration allows you to:

• Search your knowledge base directly in Claude conversations
• Create and edit notes without leaving the chat
• Get context-aware responses based on your notes
• Seamless integration with your workflow

📋 Prerequisites

• Claude Desktop application installed
• Active Knowledge AI project
• Project API key (Bearer token)

⚙️ Configuration

Step 1: Get Your Bearer Token

1. Navigate to your project's API Keys section
2. Generate a new Bearer token for Claude Desktop integration
3. Copy the token - you'll need it in step 5

Step 2: Locate Claude Desktop Config File

macOS:

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

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Step 3: Add MCP Server Configuration

Add the following configuration to your claude_desktop_config.json file:

{
  "mcpServers": {
    "knowledge-ai-YOUR_PROJECT_ID": {
      "command": "npx",
      "args": [
        "supergateway@latest",
        "-y",
        "--streamableHttp",
        "YOUR_PROJECT_MCP_URL",
        "--header",
        "Authorization: Bearer YOUR_BEARER_TOKEN_HERE"
      ]
    }
  }
}

Step 4: Replace Placeholders

• Replace YOUR_PROJECT_ID with your actual project ID
• Replace YOUR_PROJECT_MCP_URL with your project's MCP URL
• Replace YOUR_BEARER_TOKEN_HERE with the Bearer token from Step 1

Step 5: Restart Claude Desktop

Close and restart Claude Desktop for the changes to take effect.

✅ Verification

Once configured, your knowledge base will be available in Claude Desktop. You can:

1. Search: Ask Claude to search your knowledge base
2. Create: Request Claude to create new notes
3. Update: Have Claude modify existing content
4. Explore: Ask about relationships between notes

🛠️ Example Commands

"Search my knowledge base for authentication patterns"
"Create a note about the new API design"
"Show me notes related to user management"
"Update the deployment guide with the new steps"

🔧 Troubleshooting

MCP Server Not Appearing

1. Check Configuration: Verify the JSON syntax in your config file
2. Restart Claude: Completely close and reopen Claude Desktop
3. Check Token: Ensure your Bearer token is valid and active
4. Check URL: Verify the MCP URL is correct for your project

Connection Issues

1. Network: Ensure you have internet connectivity
2. Firewall: Check if your firewall is blocking the connection
3. Token Expiry: Regenerate your Bearer token if it's expired

Performance Issues

1. Large Projects: Consider using more specific search queries
2. Rate Limits: Avoid rapid successive API calls
3. Token Limits: Monitor your API usage in the dashboard

📖 Advanced Usage

Multiple Projects

You can connect multiple Knowledge AI projects by adding multiple entries to the mcpServers configuration:

{
  "mcpServers": {
    "knowledge-ai-project1": {
      "command": "npx",
      "args": ["supergateway@latest", "-y", "--streamableHttp", "PROJECT1_URL", "--header", "Authorization: Bearer TOKEN1"]
    },
    "knowledge-ai-project2": {
      "command": "npx", 
      "args": ["supergateway@latest", "-y", "--streamableHttp", "PROJECT2_URL", "--header", "Authorization: Bearer TOKEN2"]
    }
  }
}

Custom Server Names

You can customize the server name in the configuration to make it more descriptive:

{
  "mcpServers": {
    "my-docs-knowledge-base": {
      // ... configuration
    }
  }
}

🔒 Security Considerations

• Token Safety: Keep your Bearer tokens secure and don't share them
• Regular Rotation: Periodically rotate your API tokens
• Access Control: Use project-specific tokens to limit access scope
• Monitoring: Monitor API usage for unusual activity

📞 Support

Need help? Contact us:

• Email: feedback@knowledge-ai.app
• Documentation: docs.knowledge-ai.app
• Integration Guide: docs.knowledge-ai.app/integrations

---

Last updated: 2025-01-14