Connect your AI client

Agent Apps work in any MCP-compatible client via Gateway MCP.

Start a Station

agentapps serve --port 4100

Add Gateway MCP to your client

Claude Code

claude mcp add agentapps -e CONTROLLER_URL=http://localhost:4100 -- node /path/to/gateway-mcp/dist/index.js

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "agentapps": {
      "command": "node",
      "args": ["/path/to/gateway-mcp/dist/index.js"],
      "env": {
        "CONTROLLER_URL": "http://localhost:4100"
      }
    }
  }
}

Cursor, Windsurf, VS Code, Zed

See the Gateway MCP setup guide for client-specific configuration.

How it works

1. The MCP Gateway discovers all apps and their tools from the Station
2. Your AI client sees them as MCP tools
3. When the agent calls a tool, the Gateway translates the MCP call to an Agent Apps tool_call
4. The Station routes it to the correct app instance
5. The result comes back as an MCP response

Next steps

• CLI reference — full CLI command list
• Managing Agent Apps — run a Station in production