Getting Started

Quickstart

Connect your agent with native OAuth or a scoped Coconut MCP key.

Connect your agent to Coconut through HTTP MCP. Use native OAuth when your host supports it.

Connect your agent

  1. Open the setup guide for Codex, Claude Code, OpenCode, Hermes, and OpenClaw.
  2. Configure https://coconutapp.xyz/api/mcp in your host.
  3. Start the host's OAuth login.
  4. Select the Workspace, Brand, required operations, and expiry during consent.

Use the admitted development endpoint for development consent. Do not send development credentials to Production.

API-key fallback

For an unsupported host or unattended access, create a scoped MCP key in Settings → API Keys. Select the Brand, required capabilities, and expiry. Include workspace_discover for the connection check. Use your host's protected credential store or environment reference.

Keep credentials out of chat, command arguments, committed files, and logs.

Verify access

Discover tools in your agent. Call workspace_get with this input:

{}

Check the returned Workspace, Brand, capabilities, and expiry. Use current reads to obtain target identifiers and versions.

You can give your agent the Markdown setup guide. It contains setup steps and the default tool catalog.

Continue your workflow

Read the 41 business tools and two helpers.

Discovery returns only tools that the deployment and credential permit.

Read grants, revocation, and operation evidence before changes.

Agent Setup

Next