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 — paste the API key yourself.

  1. Run the LockIn installer and choose Poke when prompted — it opens 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. Paste your API key when prompted — copy from the installer (never put it in a shareable link).

  4. Click Create Integration.

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

  6. Start a new Poke chat and ask LockIn to block distractions or start a focus session.

Open Poke integrations (blank form)

Tip: The installer can also register Poke via CLI after you log in with npx poke@latest login.

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

The installer can write your config file automatically on macOS and Linux.

  1. Run the installer and choose Claude Desktop — it merges lockin-mcp into claude_desktop_config.json.

  2. On macOS the file lives at ~/Library/Application Support/Claude/claude_desktop_config.json.

  3. Restart Claude Desktop completely (quit from the menu bar, then reopen).

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

Tip: Manual edit: add an mcpServers.lockin-mcp entry with your relay URL and Authorization: Bearer YOUR_API_KEY header.

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.

Need the install command? Get started · All docs