Connect MCP clients

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.

Open settings

Go to claude.ai/settings/connectors.

Add a custom connector

Click Add custom connector at the bottom of the page.

Enter the Mokaru server URL

Name: Mokaru
Remote MCP server URL: https://api.mokaru.ai/mcp

Click Add.

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.

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.

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.

Add Mokaru

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

If you already have other mcpServers, add "mokaru" alongside them.

Restart Claude Desktop

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

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.

Open MCP settings

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

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

Save and restart

Click Save. Restart Cursor.

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.

Add the server

claude mcp add mokaru --transport http https://api.mokaru.ai/mcp

This writes the config to ~/.claude.json.

Authorize

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

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).

Open the settings file

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

Add Mokaru

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

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.

Install the Mokaru skill

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

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.

Open config

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

Add Mokaru

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

Reload

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

Zed

The Zed editor supports MCP via Context Servers.

Open settings

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

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' }
});

from mcp.client.streamable_http import streamablehttp_client
from mcp import ClientSession

async with streamablehttp_client("https://api.mokaru.ai/mcp") as (read, write, _):
    async with ClientSession(read, write) as session:
        await session.initialize()
        tools = await session.list_tools()
        print([t.name for t in tools.tools])

        result = await session.call_tool(
            "mokaru_search_jobs",
            {"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

The browser opens but I see 'MCP requires Plus'

Your Mokaru account is on the Free plan. MCP integration requires Plus. Upgrade and try again.

Authorization succeeds but tools fail with 'session expired'

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.

Claude Desktop / Cursor doesn't show Mokaru after adding the config

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.

Multiple devices, do I need to authorize each one?

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.

I get rate-limit errors

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.

How do I disconnect?

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.

Get Started

AI Agents (MCP)

Find Jobs

Apply

Track

Integrations

Account

Trust

Connect MCP clients

Claude.ai (web)

Claude Desktop

Cursor

Claude Code (CLI)

Gemini CLI

OpenClaw / ClawHub

Continue (VS Code / JetBrains)

Zed

Custom MCP clients

Troubleshooting

Don’t see your client?

​Claude.ai (web)

​Claude Desktop

​Cursor

​Claude Code (CLI)

​Gemini CLI

​OpenClaw / ClawHub

​Continue (VS Code / JetBrains)

​Zed

​Custom MCP clients

​Troubleshooting

​Don’t see your client?

Claude.ai (web)

Claude Desktop

Cursor

Claude Code (CLI)

Gemini CLI

OpenClaw / ClawHub

Continue (VS Code / JetBrains)

Zed

Custom MCP clients

Troubleshooting

Don’t see your client?