> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asteroid.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the MCP server

> Connect Claude Code or Cursor to the Asteroid MCP server, and fix common connection problems.

The MCP server signs you in through the browser. It does not take an API key.

<Tabs>
  <Tab title="Claude Code">
    <Steps>
      <Step title="Add the server">
        Run this in your terminal:

        ```bash theme={null}
        claude mcp add --transport http asteroid https://mcp.asteroid.ai/mcp
        ```
      </Step>

      <Step title="Sign in">
        Complete the browser sign-in the first time Claude Code calls an Asteroid tool. The client stores the token
        and sends it on later requests.
      </Step>

      <Step title="Check it works">
        Ask Claude Code:

        ```
        List all my Asteroid agents
        ```

        Your workflows come back in the reply.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="Add the server">
        Add this to `.cursor/mcp.json` in the project, or to `~/.cursor/mcp.json` for every project:

        ```json theme={null}
        {
          "mcpServers": {
            "asteroid": {
              "url": "https://mcp.asteroid.ai/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="Sign in">
        Accept the OAuth prompt on first use so Cursor gets a token for your Asteroid user.
      </Step>

      <Step title="Check it works">
        In the chat, ask:

        ```
        List all my Asteroid agents
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Info>
  The server speaks streamable HTTP at `/mcp`. It publishes OAuth metadata at
  `/.well-known/oauth-protected-resource` and `/.well-known/oauth-authorization-server`, so clients that
  discover authentication find it on their own.
</Info>

## When it does not connect

| Problem                        | Fix                                                                                           |
| :----------------------------- | :-------------------------------------------------------------------------------------------- |
| "Tool not found"               | Check the server is registered. Run `claude mcp list`, or read `.cursor/mcp.json`.            |
| 401 or an authentication error | Remove the server, add it again, and sign in. Check your user has access to the organization. |
| Timeouts                       | Check your network reaches `mcp.asteroid.ai`.                                                 |

<Tip>
  Give your coding agent [skill.md](https://docs.asteroid.ai/skill.md) too, so it can act on these docs
  directly. See [Point your coding agent at the docs](/build/from-your-coding-agent#point-your-coding-agent-at-the-docs).
</Tip>

## Next

<CardGroup cols={2}>
  <Card title="What the MCP server can do" icon="list" href="/mcp/tools" horizontal>Every tool, grouped by what it acts on</Card>
  <Card title="Build a workflow over MCP" icon="hammer" href="/build/from-your-coding-agent#build-a-workflow-over-mcp" horizontal>A worked example, start to finish</Card>
</CardGroup>