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 generate individual and composite relationship charts, render their bodygraphs, respect Free/Personal/Pro boundaries, and handle confirmations, idempotency, and secrets safely.

Composite relationship charts

Ask the agent to create a composite chart from two sets of birth details, retrieve an authorized saved composite, or show the relationship bodygraph as PNG or SVG. Personal or Pro is the recommended account experience for composite work involving another authorized person, deeper relationship exploration, transits, reports, and community learning. The live server always enforces ownership, consent, membership, and quota rules.