@my-architect/mcp

MCP server for My Architect — connect AI agents to your architecture workspace.

Quick Setup

Get your API token from Settings → Connect Agent at my-architect.app.

Claude Code (recommended) — via plugin marketplace

Set your token once, then install the official plugin. This auto-configures the MCP server and installs the myarchitect skill that helps Claude proactively track deferred items, caveats, and known issues in your backlog.

export MCP_API_KEY=mcp_YOUR_TOKEN   # add to ~/.zshrc or ~/.bashrc to persist

In Claude Code:

/plugin marketplace add d7561985/my-architect-marketplace
/plugin install my-architect@my-architect-marketplace

Then run /mcp to verify the server is connected, and /skills to confirm myarchitect is loaded.

Plugin source and docs: d7561985/my-architect-marketplace.

Claude Code — manual claude mcp add (fallback)

Use this if you want only the MCP server without the skill, or you cannot use the plugin marketplace.

claude mcp add my-architect \
  --scope user \
  --env MCP_API_KEY=mcp_YOUR_TOKEN \
  --env MA_API_URL=https://my-architect.app \
  -- npx -y @my-architect/mcp@latest

Then run /mcp in Claude Code to verify.

OpenClaw (via mcporter)

mcporter config add my-architect \
  "npx -y @my-architect/mcp@latest" \
  --env MCP_API_KEY=mcp_YOUR_TOKEN \
  --env MA_API_URL=https://my-architect.app

Then run mcporter list to verify.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "my-architect": {
      "command": "npx",
      "args": ["-y", "@my-architect/mcp@latest"],
      "env": {
        "MCP_API_KEY": "mcp_YOUR_TOKEN",
        "MA_API_URL": "https://my-architect.app"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MCP_API_KEY | Yes (prod) | — | API token from Settings page | | MA_API_URL | No | http://localhost:3100 | Backend URL |

Local Development

If you have the repo cloned, run the MCP server directly:

npm run mcp
# or with custom env:
MCP_API_KEY=mcp_dev MA_API_URL=http://localhost:3100 npm run mcp