Connect to an AI agent

Integrate Meko with Cursor, Claude Desktop, Claude Code, and more

Integrate with AI agents for interactive use cases, such as saving personal, team, and organizational preferences, standards, and policies.

Before you connect

  1. Generate an API key. In the portal, open Settings>API Keys>Generate API key, enter a name, then copy or download the key before closing the dialog (it starts with mko_tkn_ and is shown only once).
  2. Use the MCP server URL https://mcp.mekodata.ai/mcp (the same URL appears in the Datapacks>Connect dialog).

For any of the following integrations, replace <paste-your-api-key> with the key you saved. The portal's one-line installer uses that same placeholder.

You can also connect Meko by URL with no API key and no installer using OAuth. The client opens a browser for OAuth; your Meko portal login is the identity. The MCP server returns its tool list to the client automatically.

For the full workflow, see MCP server URL and API key.

OAuth and Manual setup

When you connect with OAuth or using the Manual setup, your agent interacts with Meko on demand only: you need to mention "Meko" in your prompt (for example, "save this to Meko," "search my Meko knowledge base") for the agent to call the tools. The agent won't proactively save conversations or capture memories unless you ask.

To get automatic behavior, use the Automated setup instead, or write your own skills to teach your agent when to call Meko tools.

Cursor Desktop

Automated setup

In the Meko portal, select Connect and follow the steps.

OAuth

In Cursor Desktop:

  1. Open Cursor > Settings > Cursor Settings > Tools & MCPs > New MCP Server.

  2. Add to mcp.json without any auth headers:

    {
  "mcpServers": {
    "meko": {
      "url": "https://mcp.mekodata.ai/mcp"
    }
  }
}

  3. Complete the OAuth handshake when the browser opens.

Manual setup

In Cursor Desktop:

  1. Choose Cursor>Settings>Cursor Settings>Tools & MCPs>New MCP Server.

  2. Modify the mcp.json file that Cursor opens to add the following MCP server configuration.

    {
  "mcpServers": {
    "meko": {
      "url": "https://mcp.mekodata.ai/mcp",
      "headers": {
        "API_KEY": "<paste-your-api-key>"
      }
    }
  }
}

    Replace <paste-your-api-key> with the API key you saved from Settings>API Keys.

    The result should look like the following:

    Cursor Desktop

  3. Verify the Connection by entering the following in chat.

    List my datapacks in Meko

Cursor Web

Claude Desktop

Automated setup

In the Meko portal, select Connect and follow the steps.

OAuth

In Claude Desktop:

  1. Open Customize > Connectors, search for Meko in the Connectors search box, and add it as a custom MCP connector with the URL https://mcp.mekodata.ai/mcp.
  2. Complete the OAuth handshake when the browser opens.
Manual setup

In Claude Desktop (whether used for Chat, Cowork, or Code):

  1. Choose Claude>Settings>Developer>Edit Config.

  2. Edit the claude_desktop_config.json file to add the following MCP Server entry. Replace <paste-your-api-key> with the token you saved.

    {
  "mcpServers": {
    "meko": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mekodata.ai/mcp",
        "--allow-http"
      ],
      "env": {
        "API_KEY": "<paste-your-api-key>"
      }
    }
  }
}

  3. Quit and restart Claude Desktop.

    The result should look like the following:

    Claude Desktop

  4. Verify the connection by entering the following in chat:

    List my datapacks in Meko

Claude Code

Automated setup

In the Meko portal, select Connect and follow the steps.

OAuth

  1. Run the setup command in your shell to add the Meko MCP server:

    claude mcp add --scope user --transport http meko https://mcp.mekodata.ai/mcp

  2. Complete the OAuth handshake when the browser opens.

Manual setup

  1. Run the setup command in your shell to add the Meko MCP server to Claude Code:

    claude mcp add --scope user --transport http meko https://mcp.mekodata.ai/mcp --header "API_KEY: <paste-your-api-key>"

    Replace <paste-your-api-key> with the API key you saved from Settings>API Keys.

  2. Verify the connection by entering the following at the command-line console:

    List my datapacks in Meko

Open AI Codex Desktop

OAuth

In Codex Desktop:

  1. Choose Codex>Settings>MCP servers>Add server>Streamable HTTP.
  2. Enter the URL https://mcp.mekodata.ai/mcp and leave the Bearer token field empty.
  3. Click Authenticate beside Meko in the list of MCP servers and complete the OAuth handshake when the browser opens.
Manual setup

In Codex Desktop:

  1. Choose Codex>Settings>MCP servers>Add server>Streamable HTTP.

  2. Enter a name for the Meko MCP server.

  3. Enter the Meko MCP server URL (https://mcp.mekodata.ai/mcp).

  4. Enter a name (such as MEKO_MCP_TOKEN) for the Bearer token environment variable, and click Save.

    The result should look like the following:

    Codex Desktop

  5. Set the MEKO_MCP_TOKEN environment variable with your Meko API key in your terminal using the following command:

    launchctl setenv MEKO_MCP_TOKEN <paste-your-api-key>

  6. Verify that you set MEKO_MCP_TOKEN correctly with your API key.

    launchctl getenv MEKO_MCP_TOKEN

  7. Quit and restart Codex Desktop.

  8. Verify the connection by entering the following in chat:

    List my datapacks in Meko

VS Code

  1. Run the following command:

    echo "### Installing the latest Node.js ###"
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.2/install.sh | bash
source ~/.$(basename $SHELL)rc
nvm install --lts
echo "### Registering the Meko MCP server ###"
npx mcp-add@latest \
  --name meko \
  --type stdio \
  --command 'npx -y mcp-remote https://mcp.mekodata.ai/mcp --allow-http' \
  --env 'MEKO_API_KEY=<paste-your-api-key>' \
  --headers 'MEKO_API_KEY=<paste-your-api-key>' \
  --scope global \
  --clients 'vscode'

    Replace <paste-your-api-key> with the API key you saved from Settings>API Keys.

  2. Verify the connection by entering the following in chat:

    List my datapacks in Meko