Claude Code

Connect Claude Code (Anthropic's terminal coding agent) to Ainecto via MCP.

---

Add the Ainecto MCP server

Use the claude mcp add command to register Ainecto:

claude mcp add ainecto https://ainecto.com/mcp \
    --transport http

Claude Code will detect the OAuth requirement and walk you through authorization the first time you make a tool call:

1. A browser window opens to Ainecto's authorization page
2. Sign in (or use an existing session)
3. Approve the consent screen
4. Claude Code receives the token and stores it in your local session

You can verify the connection with:

claude mcp list

---

Try it

In any Claude Code session:

List my Ainecto ERD documents.

Claude Code calls mcp__ainecto__list_documents with type=erd and prints the results.

Open ERD document <uuid> and show me the users table.

Claude Code calls mcp__ainecto__erd_list_tables and mcp__ainecto__erd_get_table, then renders the schema.

---

Configuration file

If you prefer manual configuration, the same server can be added to your MCP config:

{
  "mcpServers": {
    "ainecto": {
      "type": "http",
      "url": "https://ainecto.com/mcp"
    }
  }
}

Place this in the appropriate Claude Code MCP config file (consult the Claude Code MCP docs for the current location and schema).

---

Scopes & permissions

The token issued by Ainecto scopes access to your account. Claude Code can only see and modify documents you have permission to view or edit:

• OWNER / EDITOR roles → full read + write
• VIEWER role → read-only (write tool calls return a permission error)

You can revoke the token any time from Ainecto account settings → Connected apps.

---

Troubleshooting

Browser doesn't open during auth Copy the authorization URL from the terminal and open it manually.

"plan does not include MCP" MCP requires a paid plan. Upgrade in account settings, or see Plans.

Tool call returns 401 Token expired. Re-run any tool call and Claude Code will refresh automatically, or remove and re-add the server.