MCP server

The Model Context Protocol (MCP) server provides a standardized interface that allows any compatible AI model or agent to access your Katara data in a simple and secure way.

Connect to our MCP server natively in Claude, Cursor, and other clients or use the mcp-remote module for backwards compatibility with clients that do not support remote MCP.

Katara's MCP server follows the authenticated remote MCP spec, so the server is centrally hosted and managed. The Katara MCP server has tools available for getting information about agents and asking questions, with more functionality on the way.

Setup instructions

General

Our MCP server supports Streamable HTTP transports and OAuth 2.1 with dynamic client registration for authentication at https://mcp.katara.ai/mcp/

Claude

Team, Enterprise (Claude.ai)

• Navigate to Settings in the sidebar on web or desktop

• Scroll to Integrations at the bottom and click Add more

• In the prompt enter:

  • Integration name: Katara

  • Integration URL: https://mcp.katara.ai/mcp

• Make sure to enable the tools in any new chats

Free, Pro (Claude desktop)

1. Open the file ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the following and restart the Claude desktop app:

{
  "mcpServers": {
    "Katara": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.katara.ai/mcp"]
    }
  }
}

Claude Code

claude mcp add --transport http katara https://mcp.katara.ai/mcp

Then run /mcp once you've opened a Claude Code session to go through the authentication flow.

Codex

The setup steps for the MCP server are the same regardless of whether you use the IDE Extension or the CLI since the configuration is shared.

Configuration via CLI:

Run the following command in Terminal:

codex mcp add katara --url https://mcp.katara.ai/mcp

This will automatically prompt you to log in with your Katara account and connect it to your Codex.

Note: If this is the first time you are using an MCP in Codex you will need to enable the rmcp feature for this to work. Add the following into your ~/.codex/config.toml:

[features]
experimental_use_rmcp_client = true

Configuration through environment variables:

1. Open the ~/.codex/config.toml file in your preferred editor

2. Add the following:

[features]
experimental_use_rmcp_client = true

[mcp_servers.katara]
url = "https://mcp.katara.ai/mcp"

Run codex mcp login katara to move through the authentication flow.

Cursor

To add the MCP to Cursor, you can install by clicking here.

Visual Studio Code

{
  "mcpServers": {
    "Katara": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.katara.ai/mcp"]
    }
  }
}

1. CTRL/CMD + P and search for MCP: Add Server.

2. Select Command (stdio)

3. Enter the following configuration, and hit enter: npx mcp-remote https://mcp.katara.ai/mcp

4. Enter the name Katara and hit enter.

5. Activate the server using MCP: List Servers and selecting Katara, and selecting Start Server.

v0 by Vercel

1. Go to the MCP connections page

2. Click Add MCP then select Custom MCP

3. Enter the name Katara

4. Enter the URL https://mcp.katara.ai/mcp

5. Select OAuth for Authentication

6. Click Authorize and sign in

Windsurf

1. CTRL/CMD + , to open Windsurf settings.

2. Under Scroll to Cascade ➜ MCP servers

3. Select Add Server ➜ Add custom server

4. Add the following:

{
  "mcpServers": {
    "Katara": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.katara.ai/mcp"]
    }
  }
}

Zed

1. CMD + , to open Zed settings.

2. Add the following:

{
  "context_servers": {
    "Katara": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.katara.ai/mcp"],
      "env": {}
    }
  }
}

Others

Hundreds of other tools now support MCP servers, you can configure them to use Linear's MCP server with the following settings:

• Command: npx

• Arguments: -y mcp-remote https://mcp.katara.ai/mcp

• Environment: None

FAQ

Why am I seeing an internal server error when trying to connect?

Enter the following in the Terminal to clear saved auth info: rm -rf ~/.mcp-auth then try to connect again.

Additionally you may need to update to a newer version of node if required.