Skip to main content
Query your data layers directly from Claude Desktop using AstroBee’s MCP server.

Prerequisites

  • Claude Desktop 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:
{
  "mcpServers": {
    "astrobee": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-remote", "https://app.astrobee.ai/mcp"],
      "env": {
        "ASTROBEE_API_KEY": "your-api-key-here"
      }
    }
  }
}
  1. Replace your-api-key-here with your actual API key
  2. 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

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

Next Steps