AI assistants

Overview

Think of it like giving your AI assistant a direct connection to your music library. Instead of manually copying chords and lyrics back and forth, your AI can read and update your songs directly.

Akordo uses the Model Context Protocol (MCP) for a secure, standardized connection between AI tools and your Akordo account.

Note: MCP access requires a license that includes this feature. Check Account settings to verify MCP is available for your account.

What you can do

Once connected, you can ask your AI assistant to help with your music:

• Browse your library: "Show me all songs in the key of G".
• Create songs: "Create a new song called Summer Jam with these chords: G, C, D".
• Edit charts: "Add a bridge section to My Song with the chords Em, Am, B7".
• Manage setlists: "Add Wonderwall to my rehearsal setlist".
• Undo mistakes: "Restore yesterday's version of my chart".
• Explore arrangements: "What arrangements do I have for Hotel California?".

Connecting your AI assistant

Akordo supports two connection approaches:

• API key (recommended): Quick setup, works well with Claude Code.
• OAuth (advanced): Browser-based login for organizations or users who prefer not to use API keys.

You can find API keys and connection details in Settings -> API Keys in Akordo.

Claude Code setup

1. Go to Settings -> API Keys in Akordo.
2. Copy your API key (or create a new one).
3. Open your Claude Code MCP config file (usually .mcp.json in your project root).
4. Add Akordo as an HTTP MCP server:

{
  "mcpServers": {
    "akordo": {
      "type": "http",
      "url": "https://akordo.app/api/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

Replace your-api-key-here with your key, then restart Claude Code.

ChatGPT setup

1. Start the connection flow in your AI tool.
2. A browser window opens to Akordo authorization.
3. Approve the connection.
4. Return to ChatGPT.

Other AI tools

Any tool that supports MCP can connect to Akordo. Examples:

• Cursor
• Windsurf
• Continue.dev
• Zed

Use your tool's MCP setup docs with the same Akordo server pattern as above.

Security tips

• Keep API keys private: Treat them like passwords.
• Revoke unknown keys: Delete anything you do not recognize.
• Review connected apps: Audit keys and app connections periodically.
• Scope awareness: Connected tools can read/write songs, setlists, and arrangements.

Troubleshooting

Authentication failures

If your AI tool can't connect:

1. Verify the API key: Make sure you copied the full key with no extra spaces
2. Check the URL: The MCP endpoint is https://akordo.app/api/mcp (not /api/v1/mcp)
3. Confirm your license: MCP access requires a license that includes this feature — check Account settings
4. Regenerate the key: If the key was created a while ago, try creating a fresh one

Next steps

• Songs docs
• Setlists docs
• Account settings — manage your API keys
• API v1 — versioned HTTP API and OpenAPI reference