# Set up DoDomain in OpenCode: MCP and SDK

> Connect OpenCode to DoDomain's remote MCP server with OAuth, install the SDK and verify it, or paste one sentence and let it do the work.

- Canonical HTML page: https://dodomain.io/agent-setup/opencode
- This Markdown twin: https://dodomain.io/agent-setup/opencode.md
- Site index for agents: https://dodomain.io/llms.txt
- Full documentation as Markdown: https://dodomain.io/docs/llms-full.txt

Generated at build time from the same React source the HTML page renders, never a hand-maintained second copy. Every public page on this host has a twin at `<url>.md`.

---

[Agent setup](https://dodomain.io/agent-setup)

## Set up DoDomain in OpenCode

The fast way: copy this sentence into OpenCode and let it do the setup below itself.

[Add DoDomain to Claude](https://claude.ai/directory/a7fc39a1-9ea8-48f0-9d66-2ac84f2508d1): one click opens DoDomain's listing in Claude's connector directory.

Onboard your agent to DoDomain: paste this sentence into any AI coding agent.

```
Fetch and execute the appropriate instructions to set me up for DoDomain from https://dodomain.io/agent-setup/prompt.md
```

### Connect the MCP server

1. 1. Add the server to opencode.json in the project root (or ~/.config/opencode/opencode.json for every project). If the file exists, merge the dodomain entry into its mcp object.
   
   File: `opencode.json`
   
   ```
   { "$schema": "https://opencode.ai/config.json", "mcp": { "dodomain": { "type": "remote", "url": "https://app.dodomain.io/api/mcp", "enabled": true } } }
   ```
2. 2. Sign in to DoDomain (opens the browser for the OAuth consent)
   
   ```
   opencode mcp auth dodomain
   ```

**Sign in.** opencode mcp auth dodomain opens the DoDomain sign-in and consent page in the browser. OpenCode also starts this flow by itself the first time the server answers 401. 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 68 tools that cover every dashboard action.
- **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](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
  ```
- dodomain-sdk (Python 3.10+ server)
  
  The same server surface as @dodomain/node, sync and async.
  
  ```
  pip install dodomain-sdk
  ```
- @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
  ```
- @dodomain/react (React)
  
  The widget as a useDoDomainConnect hook.
  
  ```
  npm install @dodomain/react
  ```

### 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.

### Start on the free plan

No card, no sales call: create an app, mint a session, and watch the first domain verify.

[Start with 50 free](https://app.dodomain.io/signin?mode=signup) [Read the quickstart](https://dodomain.io/docs)

OpenCode's own MCP documentation: [https://opencode.ai/docs/mcp-servers/](https://opencode.ai/docs/mcp-servers/). Other agents: [all agent guides](https://dodomain.io/agent-setup).