Installation guide
Connect your AI tool to the Klaxoon MCP server using marketplace installation, OAuth auto-discovery, or your own OAuth application.
Connect your AI tool to the Klaxoon MCP server so you can work with boards (sticky-notes, text, shapes, and more).
Option 1: Marketplace installation (recommended)
Install the Klaxoon MCP connector from your AI tool marketplace when it is available for your workspace.
- ChatGPT: available from the ChatGPT marketplace.
- Anthropic: coming soon to the Anthropic marketplace.
Option 2: Manual installation with OAuth auto-discovery
Use OAuth auto-discovery to connect without copying or pasting a token.
Use the server URL https://api.klaxoon.com/mcp in the configuration for your client.
Manual installation is also possible with clients that support remote MCP server configuration, including:
- Gemini, with an Enterprise license (need to be declared by an admin).
- Microsoft Copilot (need to be declared by an Copilot Studio admin)
- Mistral.
- Add the Klaxoon MCP server to your client.
- Start the MCP connection from your client.
- Complete the browser sign-in flow with your Klaxoon account.
- Return to your client after the session is configured automatically.
Add this configuration to .cursor/mcp.json for the current project, or to ~/.cursor/mcp.json for all projects:
{
"mcpServers": {
"klaxoon": {
"url": "https://api.klaxoon.com/mcp"
}
}
}Use one of these configuration file locations:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"klaxoon": {
"url": "https://api.klaxoon.com/mcp"
}
}
}Run this command:
claude mcp add --transport http --callback-port 56447 klaxoon https://api.klaxoon.com/mcpAdd this configuration to ~/.codex/config.yaml:
mcp_oauth_callback_port = 56447
[mcp_servers.klaxoon]
url = "https://api.klaxoon.com/mcp"Keep the callback port fixed at
56447. The production OAuth redirect URI is registered for that specific port.
Optional: Use your own OAuth application for manual installation
Use your own OAuth application if your client does not support auto-discovery, or if you want to manage your own OAuth credentials.
- Create an OAuth application by following Register your app.
- Configure the application with these values:
- Use the
mcpscope. - Register the redirect URI required by the target client.
- Keep the generated
client_id. - Keep the generated
client_secretif the client supports custom OAuth credentials.
- Use the
{
"mcpServers": {
"klaxoon": {
"url": "https://api.klaxoon.com/mcp",
"auth": {
"CLIENT_ID": "<your-client-id>",
"CLIENT_SECRET": "<your-client-secret>",
"scopes": ["mcp"]
}
}
}
}{
"mcpServers": {
"klaxoon": {
"url": "https://api.klaxoon.com/mcp",
"auth": {
"CLIENT_ID": "<your-client-id>",
"CLIENT_SECRET": "<your-client-secret>",
"scopes": ["mcp"]
}
}
}
}Run this command:
claude mcp add --transport http --client-id <your-client-id> --client-secret klaxoon https://api.klaxoon.com/mcpCodex does not support custom client_id or client_secret configuration. Send an authorization token in the request headers instead.
You can generate a temporary token from the Klaxoon interface in your app form, or use the full OAuth process described in Authorization.
[mcp_servers.klaxoon]
url = "https://api.klaxoon.com/mcp"
headers = "Authorization: Bearer <token>"Updated 12 days ago
