Getting Started

Quickstart

Get Coconut working with Claude Code in 2 minutes.

Get your Coconut MCP server connected to Claude Code.

Prerequisites

Step 1: Get Your API Key

  1. Sign in to coconutapp.xyz
  2. Go to SettingsAPI Keys
  3. Click Create API Key
  4. Copy the key (you'll only see it once)

Keep your API key secret. Never commit it to version control or share it publicly.

Step 2: Configure Claude Code

Add Coconut to your Claude Code MCP configuration. Open your config file:

Terminal
code ~/.claude/claude_code_config.json

Add the Coconut MCP server:

claude_code_config.json
{
  "mcpServers": {
    "coconut": {
      "type": "http",
      "url": "https:<COMMENT>//coconutapp.xyz/api/mcp",</COMMENT>
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with the API key you created in Step 1.

Step 3: Restart Claude Code

Restart Claude Code to load the new MCP configuration:

claude --mcp-debug

The --mcp-debug flag shows MCP connection status. You should see:

coconut: 11 tools available

Step 4: Test the Connection

Ask Claude to check your workspace:

What's my Coconut workspace status?

Claude will use the workspace_stats tool to show your workspace overview.

Next Steps

Troubleshooting

Claude Code shows 'Capabilities: none'

This usually means the Authorization header isn't being sent correctly. Check that:

  1. Your API key is valid (test it at coconutapp.xyz/settings)
  2. The Authorization header uses Bearer prefix (with a space)
  3. You've restarted Claude Code after changing config
'Authentication failed' errors
Your API key may be invalid or expired. Generate a new one at coconutapp.xyz/settings.
Tools return 'workspace not found'
Make sure you have at least one workspace in Coconut. Sign in to coconutapp.xyz and create a workspace if needed.

Build your brand
with agents

Let AI handle the content grind while you focus on what matters. Coconut + Claude Code = effortless brand building.