One MCP connection, four agent surfaces.

Use the hosted endpoint directly, download the Claude Code project files, or install the dual-format plugin package prepared for Claude Code and the universal ChatGPT/Codex plugin system.

Claude Code: quickest setup

1. Open the project directory and run claude.
2. If Claude Code says it is logged out, run /login.
3. Approve the project and its .mcp.json when prompted.
4. Run /mcp, select human-design-ai, and complete HumanDesign.ai OAuth.

Alternatively, after Claude Code is logged in, add the user-scoped connection:

claude mcp add --transport http --scope user human-design-ai https://mcp.humandesign.ai/
claude mcp login human-design-ai

For a shared project, save the following as .mcp.json at the project root.

{
  "mcpServers": {
    "human-design-ai": {
      "type": "http",
      "url": "https://mcp.humandesign.ai/"
    }
  }
}

Claude.ai and Claude Desktop

1. Open Customize → Connectors.
2. Select Add custom connector.
3. Use https://mcp.humandesign.ai/ as the remote MCP URL.
4. Select Connect and complete HumanDesign.ai OAuth.
5. Enable HumanDesign.ai from the connector menu in a conversation.

Team and Enterprise owners add the connector in Organization settings first; each member then connects their own HumanDesign.ai account.

Codex

[mcp_servers.human_design_ai]
url = "https://mcp.humandesign.ai/"
auth = "oauth"
startup_timeout_sec = 30
tool_timeout_sec = 60

codex mcp login human_design_ai

ChatGPT

1. Enable Developer mode under Settings → Security and login.
2. Open Plugins, select the plus button, and add the remote MCP URL https://mcp.humandesign.ai/.
3. Scan and review the discovered tools, then complete OAuth.
4. Enable the connection in a new Work conversation and test representative read-only prompts first.

What the plugin adds

The package contains both Claude and OpenAI plugin manifests, the remote MCP definition, branded assets, and a workflow skill that teaches the agent how to use individual charts and saved composite relationship charts, render authorized bodygraphs, respect Free/Individual/Personal/Pro boundaries, and handle confirmations, idempotency, and secrets safely.

Composite relationship charts

With OAuth, Personal and Pro members can retrieve and render saved composites they are authorized to access. Creating a new composite from two sets of birth details uses the separate calculation surface and therefore requires a protected HumanDesign.ai API key; it consumes one calculation unit after validation. The live server always enforces ownership, consent, membership, credential type, and quota rules.

Why connect a membership?

Free gives every member a dependable own-chart starting point, while Individual adds account-usage visibility within that same own-chart boundary. Personal opens the broader authorized chart and saved-composite library, owned reports, professionals, community learning, and connections with people exploring similar design patterns. Pro extends that into professional workspaces. Website Builder tools appear only when HumanDesign.ai has enabled the Builder for your account, and only when tools/list advertises them. HumanDesign.ai memberships also provide a deeper experience inside the HumanDesign.ai platform, including eligible transit features; the MCP's get_transits calculation tool separately requires a Startup-or-higher API key. The downloadable agent guidance itself stays neutral: it explains a missing entitlement once and follows the live catalog rather than inserting repeated upgrade promotions into conversations.