Remote MCP Server Setup

pokke-api provides an MCP (Model Context Protocol) endpoint that allows AI agents to interact with your bookmarks. By setting this up, AI tools can search or create bookmarks directly in your workspace.

Capabilities

The Pokke MCP server currently supports the following tools:

• create_bookmark: Create a new bookmark.
• list_bookmarks: List bookmarks in a workspace.
• search_bookmarks: Search bookmarks in a workspace.

Configuration

Authentication

The endpoint requires an API Key. You must pass your API Key in the Authorization header as Bearer <YOUR_API_KEY>.

Workspace Override

You can optionally provide a pokke-workspace-id header to specify the workspace ID for all operations (if supported by your client).

---

Setup Examples

Claude Code

Reference: Claude Code Docs

Option 1: CLI Command

Run the following command to add the Pokke MCP server to your configuration:

claude mcp add pokke-api \
  --transport http \
  https://api.pokke.femto-cloud.com/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>" \
  --header "pokke-workspace-id: <YOUR_WORKSPACE_ID>"

Option 2: Config File

Alternatively, add the following to your configuration file (.mcp.json or ~/.claude.json):

{
  "mcpServers": {
    "pokke-api": {
      "url": "https://api.pokke.femto-cloud.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>",
        "pokke-workspace-id": "<YOUR_WORKSPACE_ID>"
      }
    }
  }
}

---

Codex (OpenAI)

Reference: Codex Docs

Option 1: CLI Command

codex mcp add pokke-api \
  --url https://api.pokke.femto-cloud.com/mcp \
  --bearer_token_env_var POKKE_API_KEY

(This configures the server to use the POKKE_API_KEY environment variable for the Bearer token.)

Option 2: Config File (~/.codex/config.toml)

Edit your configuration file:

[mcp_servers.pokke-api]
url = "https://api.pokke.femto-cloud.com/mcp"
bearer_token_env_var = "POKKE_API_KEY"

If you prefer to use a static header:

[mcp_servers.pokke-api]
url = "https://api.pokke.femto-cloud.com/mcp"
http_headers = { "Authorization" = "Bearer <YOUR_API_KEY>", "pokke-workspace-id" = "<YOUR_WORKSPACE_ID>" }