AI Agent Setup (Claude Code, Cursor, Codex)

Claude Code Integration

Claude Code supports MCP servers directly. Configure OpenBoard in your global or project-level settings:

bashCopy
# Add OpenBoard MCP server to Claude Code
claude mcp add openboard -- openboard mcp

Alternatively, add it to your ~/.claude/settings.json:

jsonCopy
{
  "mcpServers": {
    "openboard": {
      "command": "openboard",
      "args": ["mcp"]
    }
  }
}

Now you can prompt Claude in your terminal:

"Claude, diagram our backend authentication architecture on OpenBoard and link the JWT refresh token flow."

Claude Code will automatically invoke create_board and batch_create_shapes, streaming the diagram directly to http://localhost:4747.

Cursor IDE Integration

In Cursor, OpenBoard allows Cursor's agent to read and generate visual diagrams while coding.

1. Open Cursor Settings (Cmd + , or Ctrl + ,).
2. Navigate to Features > MCP Servers.
3. Click Add New MCP Server:
   • Name: openboard
   • Type: command
   • Command: openboard mcp
4. Click Save. The green indicator will confirm the connection.

Claude Desktop Integration

For the Claude Desktop app, edit claude_desktop_config.json located at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

jsonCopy
{
  "mcpServers": {
    "openboard": {
      "command": "npx",
      "args": ["-y", "openboard-app", "mcp"]
    }
  }
}