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
- Navigate to Settings > MCP in AstroBee
- Copy the server configuration JSON
Step 2: Configure Claude Desktop
- Open Claude Desktop settings
- Navigate to the MCP servers configuration
- Add the AstroBee server configuration:
- Replace
your-api-key-herewith your actual API key - Restart Claude Desktop
Step 3: Verify Connection
- Start a new conversation in Claude Desktop
- Ask Claude to list available data layers
- 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
Tools not appearing
Tools not appearing
- Restart Claude Desktop after configuration changes
- Verify your API key is valid
- Check that you have at least one published data layer
Connection errors
Connection errors
- Ensure your network can reach app.astrobee.ai
- Check that your API key has the correct permissions
- Try regenerating your API key

