AI Tools & IDE Integration

Connect your preferred AI developer tool, agent, or IDE to your live PocketBase databases in seconds.

---

1. Claude.ai (Web & Mobile via OAuth 2.0 PKCE)

Connect Claude directly to Pocket Kit without manually copying tokens:

1. In Claude.ai, go to Settings → Connectors (or MCP Integrations).
2. Click Add Connector and enter your server URL:

   https://mcp.pocket-kit.naftalmatoya.tech/sse

3. A popup will open displaying the Pocket Kit Authorization Screen.
4. Click “Approve Access” to grant Claude secure delegated access to your database instances.
5. Claude is now connected and can run queries, inspect schemas, write hooks, and seed data directly from your chat!

---

2. Claude Code CLI

Run this command in your project terminal:

Terminal

claude mcp add pocket-kit https://mcp.pocket-kit.naftalmatoya.tech/sse \
  --header "Authorization: Bearer fuko_mcp_YOUR_TOKEN_HERE"

---

3. Cursor IDE

1. Open Cursor Settings -> Features -> MCP.
2. Click + Add New MCP Server.
3. Set the following fields:
   • Name: Pocket Kit
   • Type: SSE
   • URL: https://mcp.pocket-kit.naftalmatoya.tech/sse
   • Header: Authorization: Bearer fuko_mcp_YOUR_TOKEN_HERE

Or edit your project configuration file:

.cursor/mcp.json

{
  "mcpServers": {
    "pocket-kit": {
      "url": "https://mcp.pocket-kit.naftalmatoya.tech/sse",
      "headers": {
        "Authorization": "Bearer fuko_mcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

---

3. Windsurf / Codeium

Add the server configuration to your global or workspace Windsurf config:

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pocket-kit": {
      "serverUrl": "https://mcp.pocket-kit.naftalmatoya.tech/sse",
      "headers": {
        "Authorization": "Bearer fuko_mcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

---

4. Google Gemini CLI

For agents and CLI tools powered by the Gemini SDK or Google Antigravity/Gemini CLI:

~/.gemini/mcp_servers.json

{
  "pocket-kit": {
    "url": "https://mcp.pocket-kit.naftalmatoya.tech/sse",
    "headers": {
      "Authorization": "Bearer fuko_mcp_YOUR_TOKEN_HERE"
    },
    "timeout": 30000
  }
}

---

5. OpenAI Codex / Custom Agents

For OpenAI Assistants, LangChain, or custom tool-calling agents using JSON-RPC directly over HTTP:

agent.ts

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { SSEClientTransport } from '@modelcontextprotocol/sdk/client/sse.js';

const transport = new SSEClientTransport(
  new URL('https://mcp.pocket-kit.naftalmatoya.tech/sse'),
  {
    eventSourceInit: {
      headers: {
        Authorization: 'Bearer fuko_mcp_YOUR_TOKEN_HERE',
      },
    },
  }
);

const client = new Client({ name: 'custom-ai-agent', version: '1.0.0' }, { capabilities: {} });
await client.connect(transport);

// List available PocketBase tools
const tools = await client.listTools();
console.log('Active MCP tools:', tools);

---

6. Claude Desktop

Add the server entry to your Claude Desktop configuration:

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

{
  "mcpServers": {
    "pocket-kit": {
      "url": "https://mcp.pocket-kit.naftalmatoya.tech/sse",
      "headers": {
        "Authorization": "Bearer fuko_mcp_YOUR_TOKEN_HERE"
      }
    }
  }
}

---

7. Guidance for Unlisted & Custom MCP Clients

If your AI coding tool is not listed above, configure it using standard MCP SSE specifications:

Connection Parameters

• Transport Type: Server-Sent Events (SSE) or Direct JSON-RPC over HTTP.
• SSE Endpoint: https://mcp.pocket-kit.naftalmatoya.tech/sse
• Direct RPC POST Endpoint: https://mcp.pocket-kit.naftalmatoya.tech/mcp/call
• Authorization Header: Authorization: Bearer <your_personal_mcp_token>

Troubleshooting & Common Gotchas

1. Missing Authorization Header: Unauthenticated requests receive 401 Unauthorized. Ensure your client passes the Authorization: Bearer fuko_mcp_... header during the initial SSE handshake.
2. Streaming Timeout Settings: If your client terminates idle connections quickly, set client keepalive or heartbeat timeouts to >= 30s.
3. Environment Variable Injection: For CLI tools that accept environment variables, export:

   Terminal

   export pocket-kit_MCP_URL="https://mcp.pocket-kit.naftalmatoya.tech/sse"
   export pocket-kit_MCP_TOKEN="fuko_mcp_YOUR_TOKEN_HERE"