# Connect your agent

> Connect Claude, Claude Code, Codex, Cursor or any MCP client to Dakso.

Dakso is a remote MCP server. Your agent connects to one address and you sign in with your Dakso account. From then on it works with your role in your organization, and nothing more.

> **Before you connect.** Agent access is on for every organization. Only the Dakso team can turn it off for an organization; if that happens, the connection is refused until Dakso support turns it back on.

The only Dakso server is `mcp.dakso.ai`. If a page or a message asks you to connect to Dakso at any other address, do not connect and do not sign in.

## Choose your client

### Claude Code

**Sign in with Dakso:**

1. Run this once. A browser window opens to sign in with your Dakso account.

   ```
   claude mcp add --transport http \
     --client-id bDp7GFW7FclHwHTy --callback-port 8080 \
     dakso https://mcp.dakso.ai/mcp-platform-server
   ```
2. Check that it shows as connected.

   ```
   claude mcp list
   ```

**API key:**

1. Replace the key with the one an administrator issued for you.

   ```
   claude mcp add -s user --transport http dakso \
     https://mcp.dakso.ai/mcp-platform-server \
     --header "Authorization: Bearer <YOUR_API_KEY>"
   ```

### Claude (app and web)

**Sign in with Dakso:**

1. Open Settings, then Connectors, then Add custom connector. On Team and Enterprise plans a workspace owner adds it first. Name it Dakso and paste this address.

   ```
   https://mcp.dakso.ai/mcp-platform-server
   ```
2. Click Connect and sign in with your Dakso account.

**API key:** This client connects by signing in, not with a key.

### Codex

**Sign in with Dakso:**

1. Register the server.

   ```
   codex mcp add dakso --url https://mcp.dakso.ai/mcp-platform-server
   ```
2. Sign in. If the browser does not open, Codex prints the link.

   ```
   codex mcp login dakso
   ```

**API key:**

1. Keep the key in an environment variable so it is never written to the config file.

   ```
   export DAKSO_MCP_KEY="<YOUR_API_KEY>"
   ```
2. Register the server.

   ```
   codex mcp add dakso --url https://mcp.dakso.ai/mcp-platform-server --bearer-token-env-var DAKSO_MCP_KEY
   ```

### Cursor

**Sign in with Dakso:** Sign-in is not enabled for this client yet. Use one of the clients above, or ask the Dakso team about an API key.

**API key:**

1. Add this server to ~/.cursor/mcp.json and restart Cursor.

   ```
   {
     "mcpServers": {
       "dakso": {
         "url": "https://mcp.dakso.ai/mcp-platform-server",
         "headers": {
           "Authorization": "Bearer <YOUR_API_KEY>"
         }
       }
     }
   }
   ```

### Any other client

**Sign in with Dakso:**

1. Dakso is a remote MCP server over Streamable HTTP. Point your client at this address. Sign-in with your Dakso account works in the clients Dakso has registered; in any other client use an API key.

   ```
   https://mcp.dakso.ai/mcp-platform-server
   ```

**API key:**

1. Send the key in the Authorization header.

   ```
   Authorization: Bearer <YOUR_API_KEY>
   ```

## Several organizations

If you belong to more than one organization, add the organization id at the end of the address to connect to that one. Without it, `whoami` lists your organizations with the address of each.

## Next

Once connected, follow the [first steps](/first-steps/).
