Skip to main content
This page covers every common MCP client. Pick yours below.
Server URL for all clients: https://api.mokaru.ai/mcpAuth: OAuth in browser, the first time you use a tool. Requires a Plus plan.

​
Claude.ai (web)

Anthropic’s web app supports remote MCP servers via the Connectors feature.
1

Open settings

Go to claude.ai/settings/connectors.
2

Add a custom connector

Click Add custom connector at the bottom of the page.
3

Enter the Mokaru server URL

  • Name: Mokaru
  • Remote MCP server URL: https://api.mokaru.ai/mcp
Click Add.
4

Authorize

Claude opens a Mokaru sign-in page in a new tab. Sign in (or you’re already signed in), click Allow access, and you’re redirected back.
5

Use it

Start a new chat. Mokaru appears in the connectors picker. Try:
Search Mokaru for remote product manager jobs posted this week.
Custom connectors require Claude Pro, Max, Team, or Enterprise. Free tier users see the Connectors page but cannot add custom servers.

​
Claude Desktop

The native macOS/Windows app. Setup is via JSON config.
1

Open the config file

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
Create it if it doesn’t exist.
2

Add Mokaru

{
  "mcpServers": {
    "mokaru": {
      "url": "https://api.mokaru.ai/mcp"
    }
  }
}
If you already have other mcpServers, add "mokaru" alongside them.
3

Restart Claude Desktop

Quit and reopen the app. Mokaru should appear in the tools picker (the little plug icon near the message input).
4

Authorize on first use

The first time Claude calls a Mokaru tool, your browser opens to sign in and approve. The token is then cached locally until it expires.

​
Cursor

Cursor (the AI-first editor) has built-in MCP support.
1

Open MCP settings

Cursor Settings → Features → MCP (or Cmd/Ctrl + Shift + J then search “MCP”).
2

Add a new server

Click Add new MCP server. Fill in:
  • Name: Mokaru
  • Type: URL (or streamable-http depending on Cursor version)
  • URL: https://api.mokaru.ai/mcp
3

Save and restart

Click Save. Restart Cursor.
4

Use in Cursor chat or Composer

In Cursor’s chat panel, the Mokaru tools become available alongside Cursor’s built-in coding tools. Try:
List my Mokaru job applications and their status.

​
Claude Code (CLI)

Anthropic’s command-line agent.
1

Add the server

claude mcp add mokaru --transport http https://api.mokaru.ai/mcp
This writes the config to ~/.claude.json.
2

Authorize

Start a Claude Code session: claude. On the first Mokaru tool call, your browser opens for OAuth. Approve, return to the terminal.
3

Verify

Inside a session, type:
/mcp
You should see mokaru listed as connected.

​
Gemini CLI

Google’s command-line agent (npm package @google/gemini-cli).
1

Open the settings file

~/.gemini/settings.json. Create it if it doesn’t exist.
2

Add Mokaru

{
  "mcpServers": {
    "mokaru": {
      "httpUrl": "https://api.mokaru.ai/mcp"
    }
  }
}
3

Authorize on first run

Run gemini in your terminal. The first call to a Mokaru tool opens your browser for OAuth.
Gemini Code Assist (the JetBrains / VS Code extension) reads the same ~/.gemini/settings.json for agent mode, so the same config works in both.

​
OpenClaw / ClawHub

Mokaru maintains an official skill on ClawHub - this is the easiest path if you use OpenClaw.
1

Install the Mokaru skill

Visit clawhub.ai/VNDCK/auto-apply and click Install to add it to your OpenClaw agent.
2

Or use raw MCP

If you want the full MCP toolset instead of the curated skill, add Mokaru as a custom MCP server in OpenClaw’s settings:
{
  "mcpServers": {
    "mokaru": {
      "url": "https://api.mokaru.ai/mcp"
    }
  }
}

​
Continue (VS Code / JetBrains)

Open-source AI assistant for editors.
1

Open config

Edit ~/.continue/config.yaml (or config.json in older versions).
2

Add Mokaru

mcpServers:
  - name: Mokaru
    url: https://api.mokaru.ai/mcp
3

Reload

Reload the Continue extension. Mokaru’s tools become available in agent mode.

​
Zed

The Zed editor supports MCP via Context Servers.
1

Open settings

Cmd + , (macOS) or Ctrl + , (Linux) → opens settings.json.
2

Add Mokaru

{
  "context_servers": {
    "mokaru": {
      "source": "custom",
      "url": "https://api.mokaru.ai/mcp"
    }
  }
}

​
Custom MCP clients

Building your own agent? The MCP TypeScript and Python SDKs handle the full OAuth + transport flow when you point them at the Mokaru server URL. 
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(
  new URL('https://api.mokaru.ai/mcp')
);

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

const { tools } = await client.listTools();
console.log(tools.map(t => t.name));

const result = await client.callTool({
  name: 'mokaru_search_jobs',
  arguments: { query: 'product manager', location: 'Amsterdam' }
});
Both SDKs auto-discover the OAuth endpoints, handle Dynamic Client Registration, run the browser flow, and refresh tokens. You don’t need to implement any of it yourself - just provide the URL. For the low-level OAuth wire protocol (if you’re building an MCP client from scratch), see the OAuth flow reference.

​
Troubleshooting

Your Mokaru account is on the Free plan. MCP integration requires Plus. Upgrade and try again.
Access tokens last 1 hour; refresh tokens last 30 days. If you haven’t used the connection in over a month, the refresh chain is dead. Disconnect from Mokaru → Settings → MCP connections and re-authorize.
You need to fully quit and restart the app - reload-from-settings isn’t enough for MCP servers. On macOS that means Cmd + Q, not just closing the window.
Yes - each MCP client instance is a separate OAuth client and gets its own connection. Claude Desktop on your laptop and Claude Desktop on your work machine appear as two entries in Mokaru → Settings → MCP connections. You can revoke them independently.
The MCP endpoint enforces two limits: 100 requests per 10 seconds per IP, and 60 requests per minute per OAuth client. Individual /v1/* endpoints also have their own rate limits. Wait the Retry-After seconds returned in the RateLimit-Reset header.
Mokaru → Settings → Integrations → MCP connections. Click Disconnect on the agent you want to revoke. All access tokens for that agent stop working immediately.

​
Don’t see your client?

Any MCP-compatible client that supports the streamable HTTP transport and OAuth 2.1 works against https://api.mokaru.ai/mcp. If your client only supports stdio transport, it cannot connect to a remote MCP server. Found a client that should be listed here? Email us at support@mokaru.ai and we’ll add setup steps.