Connect your AI assistant

Claude (web & desktop)

1. Open Customize → Connectors, click + and choose Add custom connector.
2. Name it NativeDiagram and paste the MCP server URL, then click Add.
3. Click Connect, sign in, and choose Allow.
4. In a chat, enable it from the + menu → Connectors.

Free plans can add one custom connector. On Team and Enterprise, an owner first adds it under Organization settings → Connectors; members then connect from Customize → Connectors.

Claude Code

claude mcp add --transport http nativediagram https://diagram.dsoou.com/mcp

Start Claude Code, run /mcp, select nativediagram and choose Authenticate.

ChatGPT

1. Open Settings → Apps (called Plugins or Connectors on some plans) → Advanced settings and turn on Developer mode.
2. Choose Create, enter the name and the MCP server URL, and select OAuth authentication.
3. Confirm, sign in, and choose Allow. Enable it in a chat from the tools menu.

Developer mode availability depends on your ChatGPT plan and workspace settings.

OpenAI Codex (CLI, IDE extension & app)

codex mcp add nativediagram --url https://diagram.dsoou.com/mcp
codex mcp login nativediagram

Or add it to ~/.codex/config.toml, then run codex mcp login nativediagram:

[mcp_servers.nativediagram]
url = "https://diagram.dsoou.com/mcp"

Run /mcp inside Codex to check that the tools are listed.

Cursor

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

{
  "mcpServers": {
    "nativediagram": {
      "url": "https://diagram.dsoou.com/mcp"
    }
  }
}

Open Settings → MCP and click Connect next to nativediagram to sign in.

VS Code (GitHub Copilot)

Add to .vscode/mcp.json, or run MCP: Add Server from the Command Palette and choose HTTP:

{
  "servers": {
    "nativediagram": {
      "type": "http",
      "url": "https://diagram.dsoou.com/mcp"
    }
  }
}

Click Start above the server entry and sign in when prompted. Use it in Copilot Chat's Agent mode.

Gemini

Gemini CLI — add to ~/.gemini/settings.json, then run /mcp auth nativediagram:

{
  "mcpServers": {
    "nativediagram": {
      "httpUrl": "https://diagram.dsoou.com/mcp"
    }
  }
}

Gemini app — at gemini.google.com open Settings → Connected Apps → Add a custom app and paste the MCP server URL. Currently limited to personal Google accounts in the US.

Grok

Grok's custom connectors (Business and Enterprise) don't complete OAuth sign-in yet, so use an API key. With the xAI API:

import os
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import mcp

client = Client(api_key=os.environ["XAI_API_KEY"])
chat = client.chat.create(
    model="grok-4.6",
    tools=[mcp(server_url="https://diagram.dsoou.com/mcp", server_label="nativediagram", authorization=os.environ["DIAGRAM_API_KEY"])],
)
chat.append(user("Create a process diagram of our launch plan: Research, Design, Build, Test, Launch"))
print(chat.sample().content)

Claude API & OpenAI API

Pass the MCP server URL with an API key. Claude API (Python):

import os
import anthropic

client = anthropic.Anthropic()
response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=16000,
    betas=["mcp-client-2025-11-20"],
    mcp_servers=[{
        "type": "url",
        "url": "https://diagram.dsoou.com/mcp",
        "name": "nativediagram",
        "authorization_token": os.environ["DIAGRAM_API_KEY"],
    }],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "nativediagram"}],
    messages=[{"role": "user", "content": "Create a process diagram of our launch plan: Research, Design, Build, Test, Launch"}],
)
print(response.content)

OpenAI Responses API (Python):

import os
from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-5",
    tools=[{
        "type": "mcp",
        "server_label": "nativediagram",
        "server_url": "https://diagram.dsoou.com/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['DIAGRAM_API_KEY']}"},
        "require_approval": "never",
    }],
    input="Create a process diagram of our launch plan: Research, Design, Build, Test, Launch",
)
print(response.output_text)

Any other MCP client that supports custom headers works the same way: Authorization: Bearer nd_…

Troubleshooting

• Connected, but no tools appear — disconnect and connect again so the sign-in completes, then start a new chat.
• “Monthly limit reached” — your plan's diagrams are used up; see Billing.
• 401 with an API key — check the key wasn't revoked and is sent as Bearer.
• Download link expired — links last 7 days; recent diagrams are also on your dashboard.