Set up DoDomain in Codex

Connect the MCP server

1. 1. Register the DoDomain MCP server

   codex mcp add dodomain --url https://app.dodomain.io/api/mcp

   Copy

2. 2. Sign in to DoDomain (opens the browser for the OAuth consent)

   codex mcp login dodomain

   Copy

Sign in. codex mcp login dodomain opens the DoDomain sign-in and consent page in the browser and stores the token for later sessions. No API key is involved: the MCP server uses OAuth and refuses secret keys by design.

What you get

• The DoDomain MCP server at https://app.dodomain.io/api/mcp, with OAuth sign-in and seven tools: check_domain, list_apps, list_connections, get_connect_session, create_connect_session, verify_connect_session, reverify_connection.
• The SDK for your stack: @dodomain/node, dodomain-sdk, @dodomain/connect, @dodomain/react, with the secret key read from DODOMAIN_SECRET_KEY.
• A verified setup: the agent calls list_apps and the REST API before it reports back.

Install the SDK

Server code uses a secret key from DODOMAIN_SECRET_KEY. Create an app at https://app.dodomain.io/dashboard and copy the secret key from its API keys card. It is shown once.

• @dodomain/node (Node.js 20+ server)

  Create connect sessions, manage connections, verify signed webhooks.

  npm install @dodomain/node

  Copy

• dodomain-sdk (Python 3.10+ server)

  The same server surface as @dodomain/node, sync and async.

  pip install dodomain-sdk

  Copy

• @dodomain/connect (Browser)

  Opens the hosted connect flow as a sheet inside your own UI, driven by a session token your server minted.

  npm install @dodomain/connect

  Copy

• @dodomain/react (React)

  The widget as a useDoDomainConnect hook.

  npm install @dodomain/react

  Copy

Verify

After signing in, ask the agent to call the list_apps tool: it lists the apps on your team. To check a secret key, run:

curl -s https://app.dodomain.io/api/v1/apps -H "Authorization: Bearer $DODOMAIN_SECRET_KEY"

Success is HTTP 200 with a JSON body of the form {"apps": [...]}: a secret key sees exactly its own app, with its id, name and publishable key.