Skip to content

Claude Custom Connector Integration

Connect your Knowledge AI project to Claude with cross-device synchronization, including mobile support. This integration allows seamless access to your knowledge base across all your Claude devices.

🚀 Overview

The Claude Custom Connector provides:

  • Cross-Device Sync: Access on desktop and mobile Claude apps
  • Real-Time Updates: Instant synchronization across all devices
  • Mobile Support: Full functionality in Claude mobile app
  • Cloud-Based: Secure cloud synchronization
  • No Device Configuration: Setup once, works everywhere

📱 Device Support

  • ✅ Claude Desktop (macOS, Windows, Linux)
  • ✅ Claude Mobile App (iOS, Android)
  • ✅ Claude Web Interface
  • ✅ All future Claude platforms

📋 Prerequisites

  • Claude account (desktop and/or mobile)
  • Active Knowledge AI project
  • Project API key

⚙️ Setup Guide

Step 1: Get Your API Key

  1. Navigate to your project's API Keys section in Knowledge AI
  2. Generate a new API key for the Claude Custom Connector
  3. Copy the API key - you'll need it in step 7

Step 2: Open Claude Settings

Desktop:

  • Open Claude Desktop
  • Go to Settings → Connectors

Mobile:

  • Open Claude mobile app
  • Tap Settings → Connectors

Web:

  • Go to Claude settings
  • Navigate to Connectors section

Step 3: Add Custom Connector

  1. Click "Add Custom Connector"
  2. You'll see a form to configure the connector

Step 4: Configure Connector Details

Connector Name: Enter a descriptive name (e.g., "My Knowledge Base")

Connector URL: Use your project's connector URL:

https://api.knowledge-ai.app/api/mcp/project/YOUR_PROJECT_ID/mcp

Step 5: Set Up Authentication

  1. Choose "API Key" as the authentication method
  2. Set the header name to: X-API-Key

Step 6: Authorization Flow

  1. Click "Connect"
  2. You'll be redirected to the Knowledge AI authorization page
  3. The page will show your project details and permissions

Step 7: Enter API Key

  1. Paste your API key from Step 1 into the authorization field
  2. Review the permissions (read/write access to your knowledge base)
  3. Click "Authorize"

Step 8: Verification

  1. You should see a success message
  2. Return to Claude - the connector should now show as "Connected"
  3. Test by asking Claude to search your knowledge base

✅ Cross-Device Benefits

Instant Synchronization

  • Set up once on any device
  • Automatically available on all other devices
  • No need to reconfigure on each device

Mobile Optimization

  • Full knowledge base access on mobile
  • Touch-optimized interface
  • Offline-capable search results

Cloud Security

  • Encrypted connections
  • Secure token management
  • Automatic session handling

🛠️ Example Usage

Once connected, you can use commands like:

"Search my knowledge base for authentication patterns"
"Find my notes about API design"
"Show me everything related to deployment"
"Create a note about today's meeting"
"Update the project roadmap with new features"

📱 Mobile-Specific Features

Optimized Interface

  • Touch-friendly note creation
  • Voice-to-text note taking
  • Swipe gestures for navigation

Offline Capabilities

  • Recently accessed notes cached locally
  • Search results stored for offline viewing
  • Sync when connection restored

Location Context

  • Location-aware note suggestions
  • Geo-tagged notes (if enabled)
  • Context-sensitive search

🔧 Troubleshooting

Connector Not Appearing

  1. Check URL: Verify the connector URL is correct
  2. API Key: Ensure your API key is valid and active
  3. Network: Check internet connectivity
  4. Claude Version: Update to the latest Claude version

Authorization Issues

  1. Token Expiry: Generate a new API key
  2. Permissions: Check project access permissions
  3. Browser: Try clearing browser cache (for web version)

Sync Problems

  1. Device Connection: Ensure all devices are connected to internet
  2. Account Sync: Log out and log back into Claude
  3. Connector Status: Check connector status in settings

Performance Issues

  1. Large Projects: Use specific search terms
  2. Network Speed: Poor connection may affect performance
  3. Device Resources: Restart Claude app if needed

🔄 Managing Multiple Projects

You can connect multiple Knowledge AI projects:

  1. Separate Connectors: Add one connector per project
  2. Descriptive Names: Use clear names like "Work Docs", "Personal Notes"
  3. Project Switching: Claude will show all available connectors

Best Practices

  • Use specific connector names for easy identification
  • Organize projects by purpose (work, personal, research)
  • Regular API key rotation for security

🔒 Security & Privacy

Data Protection

  • All connections use HTTPS encryption
  • API keys are stored securely by Claude
  • No data stored on intermediate servers

Access Control

  • Project-specific API keys limit access scope
  • Revoke access instantly by deleting API keys
  • Monitor usage through Knowledge AI dashboard

Privacy Considerations

  • Only you can access your knowledge base
  • Claude respects your data privacy settings
  • No cross-user data sharing

📈 Advanced Features

Custom Workflows

  • Set up automated note creation
  • Schedule knowledge base updates
  • Integration with other Claude features

Team Collaboration

  • Share API keys for team access
  • Collaborative knowledge building
  • Real-time team updates

Analytics

  • Track usage across devices
  • Monitor search patterns
  • Optimize knowledge organization

📞 Support

Need assistance?

Quick Support Request

When contacting support, include:

  • Your project ID
  • Device type (desktop/mobile)
  • Error messages (if any)
  • Steps you've already tried

Last updated: 2025-01-14

Built with VitePress