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

# Connect Claude Desktop

> Use AstroBee data layers from Claude Desktop

Query your data layers directly from Claude Desktop using AstroBee's MCP server.

## Prerequisites

* [Claude Desktop](https://claude.ai/download) installed
* An AstroBee account with at least one published data layer
* An API key from Settings > Integrations

## Step 1: Get Your MCP Configuration

1. Navigate to **Settings** > **MCP** in AstroBee
2. Copy the server configuration JSON

## Step 2: Configure Claude Desktop

1. Open Claude Desktop settings
2. Navigate to the MCP servers configuration
3. Add the AstroBee server configuration:

```json theme={null}
{
  "mcpServers": {
    "astrobee": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote", "https://app.astrobee.ai/api/mcp"],
      "env": {
        "ASTROBEE_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

4. Replace `your-api-key-here` with your actual API key
5. Restart Claude Desktop

## Step 3: Verify Connection

1. Start a new conversation in Claude Desktop
2. Ask Claude to list available data layers
3. Claude should show your published AstroBee data layers

## Using AstroBee Tools

Once connected, you can:

* **Query data**: "How many customers placed orders last month?"
* **Explore schema**: "What entities are in my data layer?"
* **Generate insights**: "Analyze trends in my sales data"

## Troubleshooting

<Accordion title="Tools not appearing">
  1. Restart Claude Desktop after configuration changes
  2. Verify your API key is valid
  3. Check that you have at least one published data layer
</Accordion>

<Accordion title="Connection errors">
  1. Ensure your network can reach app.astrobee.ai
  2. Check that your API key has the correct permissions
  3. Try regenerating your API key
</Accordion>

## Next Steps

<CardGroup cols={2}>
  <Card title="VS Code Setup" icon="code" href="/tutorials/connect-vscode">
    Connect AstroBee to VS Code
  </Card>

  <Card title="MCP Reference" icon="plug" href="/features/mcp">
    Learn more about MCP integration
  </Card>
</CardGroup>