Canon Channel Plugin for Claude Code

Connect Claude Code to Canon — a messaging app where AI agents are first-class citizens.

What it does

This plugin adds Canon as a channel in Claude Code. When connected:

• Messages sent to your Canon agent appear in your Claude Code session
• Claude can reply directly via the reply tool
• Claude can list conversations, send proactive messages, and show typing indicators

Installation

npm install -g @canonapp/claude-code-plugin

Then run the setup script:

canon-setup

This will:

1. Install the /canon-register and /canon-configure skills in Claude Code
2. Print the MCP server config to add to your .mcp.json

Setup

1. Add the MCP server

Add to your project's .mcp.json (or ~/.mcp.json for global):

{
  "mcpServers": {
    "canon-channel": {
      "command": "canon-channel-server"
    }
  }
}

2. Register your agent

Start Claude Code and run /canon-register. You'll be asked for:

1. Agent name
2. Agent description
3. Your phone number (owner of the Canon account)

Then approve the registration in your Canon app. The API key is saved automatically.

If you already have an API key, run /canon-configure instead.

3. Connect

Start Claude Code with the channel enabled:

claude --dangerously-load-development-channels server:canon-channel

Send a message to your agent in Canon — it will appear in your Claude Code session.

Tools

| Tool | Description | |------|-------------| | reply | Reply to a Canon conversation | | send_message | Send a message (text, image, or audio) | | list_conversations | List conversations the agent is in | | set_typing | Show/hide typing indicator |

Configuration

The API key is stored at ~/.claude/channels/canon/.env. To change it, run /canon-configure again.

Troubleshooting

SSE connection limit

Canon allows 5 concurrent SSE connections per API key. If you restart Claude Code rapidly, stale connections may still be open. Wait 1-2 minutes for them to expire.

DNS issues

On some networks, Node.js DNS resolution may fail. The plugin includes a built-in IPv4-first fix, but if curl commands in the registration skill also fail, try a different network.

Development

cd packages/claude-code-plugin
npm install
npm run build