LockIn MCP
← Home

Connect your AI

After running the installer, your MCP URL and API key are saved locally at ~/.lockin/setup-manifest.json. Copy them into your AI app when prompted — never paste your API key into a chat message.

Poke

Name and MCP URL are pre-filled in the browser link — choose OAuth to connect.

  1. Run the LockIn installer or use Connect in the dashboard — both open a link with name and MCP URL pre-filled.

  2. Confirm the MCP server URL ends with /mcp (for example https://relay.lockinmcp.com/device/YOUR_ID/mcp).

  3. Choose OAuth authentication and click Connect — sign in on lockinmcp.com when prompted.

  4. For API-key auth instead, paste your key from the installer (never put it in a shareable link).

  5. Install the LockIn focus recipe for the best coaching experience.

  6. Start a new Poke chat and ask your assistant to call get_agent_guidelines, then block distractions or start a focus session.

Tip: The dashboard and installer open poke.com/integrations/new with LockIn MCP and your relay URL pre-filled — choose OAuth and connect.

LockIn recipe: Install focus coaching recipe

Claude (claude.ai)

Opens with name and URL pre-filled. Claude web uses OAuth — not API keys in Advanced settings.

  1. Run the installer and choose Claude (claude.ai) — it opens the add-connector form with name and URL pre-filled.

  2. Leave Advanced settings empty. Do not paste your API key in OAuth Client ID or Client Secret — those are for OAuth apps, not LockIn.

  3. Click Add, then start a new chat and enable LockIn. Sign in via lockinmcp.com when Claude prompts.

  4. For Bearer/API-key auth without OAuth, use Claude Desktop instead — the installer can write your config automatically.

Open Claude add-connector (blank form)

Tip: Claude web does not support static Bearer tokens in the connector form (see anthropics/claude-ai-mcp#112). Poke and Claude Desktop work with your API key directly.

Claude Desktop

Installer writes a stdio bridge via mcp-remote on macOS, Windows, and Linux.

  1. Run the installer and choose Claude Desktop — it merges lockin-mcp into claude_desktop_config.json using mcp-remote (Node.js 18+ required).

  2. Config paths: macOS ~/Library/Application Support/Claude/claude_desktop_config.json · Windows %APPDATA%\Claude\claude_desktop_config.json · Linux ~/.config/Claude/claude_desktop_config.json.

  3. Quit Claude Desktop completely (menu bar → Quit), then reopen.

  4. In a new chat, confirm LockIn tools appear in the connector list.

Tip: Claude Desktop does not accept direct url/headers entries in claude_desktop_config.json — that format causes launch errors. Use mcp-remote as shown in the README, or re-run the installer.

ChatGPT

Custom MCP connectors use OAuth — same flow as Claude web.

  1. Open ChatGPT → Settings → Connectors → Advanced (link below).

  2. Turn on Developer mode if it is not already enabled.

  3. Click Create app, enter name and your relay MCP URL (ends with /mcp).

  4. Set Authentication to OAuth. Leave Advanced OAuth settings on Dynamic Client Registration (DCR).

  5. Do not paste your LockIn API key — ChatGPT signs in via lockinmcp.com when prompted.

  6. Save, then start a new chat and enable the LockIn connector for that conversation.

Open ChatGPT Advanced Connectors

Tip: ChatGPT registers via RFC 7591 DCR against relay.lockinmcp.com, then completes OAuth on lockinmcp.com. Pro license required.

Hermes Agent

Connect via Terminal CLI or paste your MCP URL into Hermes settings.

  1. Copy your relay MCP URL from the dashboard (ends with /mcp).

  2. Option A — Terminal: hermes mcp add lockin --url "YOUR_MCP_URL" --transport streamable-http

  3. Option B — Paste: add the URL under mcp_servers.lockin.url in ~/.hermes/config.yaml

  4. In Hermes, run /reload-mcp or start a new session, then ask it to lock in.

Open Hermes MCP docs

Tip: Hermes supports OAuth on HTTP MCP servers — sign in on lockinmcp.com when prompted.

OpenClaw

Connect via Terminal CLI or paste your MCP URL into OpenClaw MCP settings.

  1. Copy your relay MCP URL from the dashboard (ends with /mcp).

  2. Option A — Terminal: openclaw mcp add lockin --url "YOUR_MCP_URL" --transport streamable-http --auth oauth

  3. Option B — Paste: add the URL in OpenClaw Control UI → /mcp or your openclaw.json config

  4. Restart the gateway (openclaw gateway restart) and verify with openclaw mcp doctor lockin --probe

Open OpenClaw MCP docs

Tip: OpenClaw's Control UI at /mcp is the easiest way to paste a URL without using Terminal.

Need the install command? Get started · All docs