Connecting an AI agent

1. Turn on the API

1. Make sure Accovod is in Applications. An app started from Downloads or a disk image refuses to copy configs: that path stops working after a restart.
2. In the menu bar, open Automation → Enable API / MCP access.

The menu then shows the API address, for example Local API: 127.0.0.1:25252.

2. Connect your client

Accovod prepares the settings for you: items in the Automation menu put the right text on the clipboard.

Claude Code

Automation → Copy Claude Code command, then paste it into Terminal:

claude mcp add --scope user accovod -- '/Applications/Accovod.app/Contents/MacOS/accovod-mcp'

--scope user matters: without it, Accovod is available only in the folder where you ran the command.

Codex

Automation → Copy Codex config (TOML) and add it to ~/.codex/config.toml (create the file if it doesn’t exist):

[mcp_servers.accovod]
command = "/Applications/Accovod.app/Contents/MacOS/accovod-mcp"
args = []

Or with one Terminal command:

codex mcp add accovod -- '/Applications/Accovod.app/Contents/MacOS/accovod-mcp'

Restart Codex.

Claude Desktop

Automation → Copy MCP config (JSON). In Claude Desktop, open Settings → Developer → Edit Config and add the block to claude_desktop_config.json:

{
  "mcpServers": {
    "accovod": {
      "command": "/Applications/Accovod.app/Contents/MacOS/accovod-mcp",
      "args": []
    }
  }
}

If the file already has mcpServers, add just accovod inside it. Restart Claude Desktop.

Cursor / Windsurf

Automation → Copy MCP config (JSON) and add it to:

• Cursor — ~/.cursor/mcp.json
• Windsurf — ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "accovod": {
      "command": "/Applications/Accovod.app/Contents/MacOS/accovod-mcp",
      "args": []
    }
  }
}

The port and token aren’t written into the config: accovod-mcp reads them from control.json on every call. Restarting Accovod doesn’t require any edits.

3. Test the connection

Ask the agent: “Check the Accovod status and show my profiles.” It will call app_status and profiles_list.

To test without an agent, run in Terminal:

/Applications/Accovod.app/Contents/MacOS/accovod-mcp --health

The Automation menu: turning on the API, ready-made configs and the token.

The Automation menu

Item	What it does
Enable API / MCP access	Turns the API on and off. Off by default.
Copy Claude Code command / Copy Codex config / Copy MCP config	Ready-made client settings.
Copy API address / Copy API token	Address and token for your own scripts.
Show control.json in Finder	The file with the current port and token.
Always use port 25252	On by default: the API runs on port 25252, or on any free port if another program holds it. Turn it off and Accovod picks a random free port on every launch.
Regenerate token	Issue a new token. The old one stops working immediately.
Stop Agent ⇧⌘.	Stop the agent. Shown while an agent is working.

Troubleshooting

• “Accovod is not running” / no response — open Accovod and check that Enable API / MCP access is on.
• A copy item refuses to work — move Accovod.app to Applications and launch it from there.
• The agent doesn’t see the tools — restart the client after editing its config. In Claude Code, check with claude mcp list.
• UNAUTHORIZED — the token was changed with Regenerate token. MCP picks up the new one by itself; paste it into your own scripts again.