Getting Started
1. Create a BrewLogica Account
Before using the MCP integration, you need a BrewLogica account. You can create one by downloading the app on iOS or Android.
2. Generate an API Token
Visit the API Tokens page and sign in with your BrewLogica account. Click "Generate" to create a new token.
Important: Copy your token immediately!
For security, tokens are only displayed once when created. Store it securely.
3. Configure Your MCP Client
Claude Code
Add the following to your .mcp.json file
in your project or home directory:
{
"mcpServers": {
"brewlogica": {
"command": "npx",
"args": [
"-y",
"@anthropic-ai/mcp-remote",
"https://api.brewlogica.app/mcp",
"--header",
"Authorization: Bearer YOUR_TOKEN_HERE"
]
}
}
} Claude Desktop
Add to your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"brewlogica": {
"command": "npx",
"args": [
"-y",
"@anthropic-ai/mcp-remote",
"https://api.brewlogica.app/mcp",
"--header",
"Authorization: Bearer YOUR_TOKEN_HERE"
]
}
}
} Cursor
Cursor supports MCP via its settings. Go to Settings → Features → MCP Servers and add the configuration above.
4. Test the Connection
After configuring your client, restart it and try asking about your coffee data:
"What beans do I have in my collection?"
"Show me my recent brews"
"Log a new espresso: 18g in, 36g out, 28 seconds"
Troubleshooting
Connection refused
Make sure your token is valid and hasn't been revoked. Check that you're using
the correct API endpoint: https://api.brewlogica.app/mcp
Authentication error
Verify your token includes the bl_ prefix
and the full token string. Tokens are case-sensitive.
MCP server not found
Ensure you have Node.js installed and can run npx commands. The MCP remote proxy will be downloaded automatically.