1. Open the ChatGPT settings and go to the connectors (apps) area. In business workspaces, an admin may first need to allow custom connectors (developer mode).
2. Create a new connector named DealDesk, paste the server URL below and choose OAuth as the authentication.
3. Sign in with agenthouse, choose your DealDesk project and allow access.
4. Start a new chat and enable DealDesk in the tools menu.

https://api.agenthouse.org/mcp/dealdesk

1. Open the Claude settings and go to Connectors. On Team and Enterprise plans, an owner adds custom connectors for the organization.
2. Add a custom connector named DealDesk and paste the server URL below.
3. Select Connect, sign in with agenthouse, choose your DealDesk project and allow access.
4. In a chat, enable DealDesk in the tools menu.

https://api.agenthouse.org/mcp/dealdesk

Gemini CLI connects through the local DealDesk bridge. In the Gemini web app, custom MCP apps are currently only available in Gemini Spark for eligible personal accounts. If you have access, add the server URL shown under “Other” there.

1. Install Node.js 20 or later and Gemini CLI.
2. Create a project API key and store it on your computer as the environment variable AGENTHOUSE_API_KEY.
3. Add the configuration below to ~/.gemini/settings.json (or .gemini/settings.json in a project) and replace YOUR_PROJECT_ID.
4. Restart Gemini CLI and run /mcp list. DealDesk should appear as connected.

{
  "mcpServers": {
    "dealdesk": {
      "command": "npx",
      "args": [
        "-y",
        "dealdesk-plugin"
      ],
      "env": {
        "AGENTHOUSE_API_URL": "https://api.agenthouse.org",
        "AGENTHOUSE_API_KEY": "$AGENTHOUSE_API_KEY",
        "AGENTHOUSE_PROJECT_ID": "YOUR_PROJECT_ID"
      }
    }
  }
}

Create a project API key under Access management → API keys. The key is shown only once. Replace the placeholders (YOUR_PROJECT_ID and, where shown, ahk_YOUR_PROJECT_API_KEY) with your own values. Never paste the key into a chat. Open access management

VS Code 1.101 or later supports remote MCP with OAuth. After saving, choose Auth above the server entry and sign in with agenthouse.

1. Open VS Code 1.101 or later with GitHub Copilot.
2. Run the command “MCP: Open User Configuration” or create .vscode/mcp.json in your project.
3. Paste the configuration below, save, and choose Auth. Sign in with agenthouse, choose at least one DealDesk project and allow access.
4. Open Copilot Chat in agent mode and enable the DealDesk tools.

{
  "servers": {
    "dealdesk": {
      "type": "http",
      "url": "https://api.agenthouse.org/mcp/dealdesk"
    }
  }
}

Sign-in with agenthouse is the intended path for these assistants. A project API key is only needed when no browser can open (for example in CI).

1. Cursor: install the DealDesk plugin, or add the server URL below as a remote MCP server. Claude Desktop and Codex: install Node.js 20 or later.
2. Claude Desktop: open claude_desktop_config.json. Codex: open its MCP configuration. Paste the local MCP configuration below.
3. Complete sign-in with agenthouse, choose at least one DealDesk project and allow access. Do not create an API key for this path.
4. Start a new chat and check the connection by listing your open DealDesk cards.

https://api.agenthouse.org/mcp/dealdesk

{
  "mcpServers": {
    "dealdesk": {
      "command": "npx",
      "args": [
        "-y",
        "dealdesk-plugin"
      ]
    }
  }
}

Requires Open WebUI 0.6.31 or later. Only administrators can add MCP servers. Choose OAuth 2.1, not Bearer and not OAuth 2.1 (Static). Do not set DealDesk as a default tool on a model. In Docker, set a stable WEBUI_SECRET_KEY or the sign-in is lost after a restart.

1. Open Settings → Admin → Integrations. Under External Tool Servers, choose Add Connection.
2. Set Type to MCP (Streamable HTTP). Paste the server URL below. Auth: OAuth 2.1. Save, then choose Register Client if offered.
3. Sign in with agenthouse, choose at least one DealDesk project and allow access.
4. Open a chat and enable DealDesk under + → Integrations → Tools. Do not set it as a default tool.

https://api.agenthouse.org/mcp/dealdesk

OpenCode detects OAuth on remote MCP automatically and registers the client with DCR. Do not set oauth to false.

1. Open opencode.json or opencode.jsonc in the project or in your user configuration.
2. Paste the configuration below under mcp and save.
3. Start OpenCode. If sign-in does not start automatically, run opencode mcp auth dealdesk. Sign in with agenthouse, choose at least one DealDesk project and allow access.
4. Start a new conversation and check the connection by listing your open DealDesk cards.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dealdesk": {
      "type": "remote",
      "url": "https://api.agenthouse.org/mcp/dealdesk"
    }
  }
}

OpenClaw connects remote MCP over Streamable HTTP. Set auth to oauth. Sign-in stores credentials on the Gateway.

1. Open the Control UI at Settings → MCP and choose Add server. Alternatively, paste the configuration below into the OpenClaw config.
2. Name: dealdesk. Transport: Streamable HTTP. URL: the address below. Auth: oauth.
3. Choose Sign in, or run openclaw mcp login dealdesk. Sign in with agenthouse, choose at least one DealDesk project and allow access.
4. Check the connection with openclaw mcp doctor dealdesk --probe and by listing your open DealDesk cards.

{
  "mcp": {
    "servers": {
      "dealdesk": {
        "url": "https://api.agenthouse.org/mcp/dealdesk",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

Hermes Agent (Nous Research) supports remote MCP with OAuth 2.1 and PKCE. Tokens are stored under ~/.hermes/mcp-tokens/, not in the configuration file.

1. Run hermes mcp add --url https://api.agenthouse.org/mcp/dealdesk --auth oauth dealdesk. Or paste the block below into ~/.hermes/config.yaml.
2. If sign-in does not start automatically, run hermes mcp login dealdesk.
3. Sign in with agenthouse, choose at least one DealDesk project and allow access.
4. Restart Hermes or run /reload-mcp. Check the connection by listing your open DealDesk cards.

mcp_servers:
  dealdesk:
    url: "https://api.agenthouse.org/mcp/dealdesk"
    auth: oauth

1. If your client supports remote MCP servers with OAuth, add the server URL and sign in with agenthouse.
2. Otherwise, run the local DealDesk bridge with the command below. It requires Node.js 20 or later.
3. Replace ahk_YOUR_PROJECT_API_KEY and YOUR_PROJECT_ID with your values, or set both as environment variables in your client.

https://api.agenthouse.org/mcp/dealdesk

AGENTHOUSE_API_URL=https://api.agenthouse.org AGENTHOUSE_API_KEY=ahk_YOUR_PROJECT_API_KEY AGENTHOUSE_PROJECT_ID=YOUR_PROJECT_ID npx -y dealdesk-plugin

Create a project API key under Access management → API keys. The key is shown only once. Replace the placeholders (YOUR_PROJECT_ID and, where shown, ahk_YOUR_PROJECT_API_KEY) with your own values. Never paste the key into a chat. Open access management