DealDesk

1. Aprite le impostazioni di ChatGPT e andate nell’area dei connettori (app). Nei workspace aziendali un amministratore potrebbe dover prima consentire i connettori personalizzati (modalità sviluppatore).
2. Create un nuovo connettore chiamato DealDesk, incollate l’URL del server qui sotto e scegliete OAuth come autenticazione.
3. Accedete con agenthouse, scegliete il vostro progetto DealDesk e consentite l’accesso.
4. Avviate una nuova chat e attivate DealDesk nel menu degli strumenti.

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

1. Aprite le impostazioni di Claude e andate su Connettori. Nei piani Team ed Enterprise un proprietario aggiunge i connettori personalizzati per l’organizzazione.
2. Aggiungete un connettore personalizzato chiamato DealDesk e incollate l’URL del server qui sotto.
3. Selezionate Connetti, accedete con agenthouse, scegliete il vostro progetto DealDesk e consentite l’accesso.
4. In una chat, attivate DealDesk dal menu degli strumenti.

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

Gemini CLI si collega tramite il bridge DealDesk locale. Nell’app web di Gemini le app MCP personalizzate sono attualmente disponibili solo in Gemini Spark per gli account personali idonei. Se avete accesso, aggiungete lì l’URL del server indicato in «Altri».

1. Installate Node.js 20 o successivo e Gemini CLI.
2. Create una chiave API di progetto e salvatela sul vostro computer nella variabile d’ambiente AGENTHOUSE_API_KEY.
3. Aggiungete la configurazione qui sotto a ~/.gemini/settings.json (o .gemini/settings.json in un progetto) e sostituite YOUR_PROJECT_ID.
4. Riavviate Gemini CLI ed eseguite /mcp list. DealDesk dovrebbe risultare collegato.

{
  "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 una chiave API di progetto in Gestione accessi → Chiavi API. La chiave viene mostrata una sola volta. Sostituite i segnaposto (YOUR_PROJECT_ID e, se presente, ahk_YOUR_PROJECT_API_KEY) con i vostri valori. Non incollate mai la chiave in una chat. Apri gestione accessi

VS Code 1.101 o successivo supporta MCP remoto con OAuth. Dopo il salvataggio, scegliete Auth sopra la voce del server e accedete con agenthouse.

1. Aprite VS Code 1.101 o successivo con GitHub Copilot.
2. Eseguite il comando «MCP: Open User Configuration» oppure create .vscode/mcp.json nel vostro progetto.
3. Incollate la configurazione qui sotto, salvate e scegliete Auth. Accedete con agenthouse, scegliete almeno un progetto DealDesk e consentite l’accesso.
4. Aprite Copilot Chat in modalità agente e attivate gli strumenti DealDesk.

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

L’accesso con agenthouse è il percorso previsto per questi assistenti. Una chiave API di progetto serve solo se non è possibile aprire un browser (ad esempio in CI).

1. Cursor: installate il plugin DealDesk oppure aggiungete l’URL del server qui sotto come MCP remoto. Claude Desktop e Codex: installate Node.js 20 o successivo.
2. Claude Desktop: aprite claude_desktop_config.json. Codex: aprite la sua configurazione MCP. Incollate la configurazione MCP locale qui sotto.
3. Completate l’accesso con agenthouse, scegliete almeno un progetto DealDesk e consentite l’accesso. Non create una chiave API per questo percorso.
4. Avviate una nuova chat e verificate la connessione elencando le schede DealDesk aperte.

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

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

Richiede Open WebUI 0.6.31 o successivo. Solo gli amministratori possono aggiungere server MCP. Scegliete OAuth 2.1, non Bearer e non OAuth 2.1 (Static). Non impostate DealDesk come strumento predefinito di un modello. In Docker impostate un WEBUI_SECRET_KEY stabile, altrimenti l’accesso si perde al riavvio.

1. Aprite Impostazioni → Admin → Integrazioni. In External Tool Servers scegliete Add Connection.
2. Impostate Type su MCP (Streamable HTTP). Incollate l’URL del server qui sotto. Auth: OAuth 2.1. Salvate e scegliete Register Client se proposto.
3. Accedete con agenthouse, scegliete almeno un progetto DealDesk e consentite l’accesso.
4. Aprite una chat e attivate DealDesk in + → Integrations → Tools. Non impostatelo come strumento predefinito.

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

OpenCode rileva automaticamente OAuth sui server MCP remoti e registra il client con DCR. Non impostate oauth su false.

1. Aprite opencode.json o opencode.jsonc nel progetto o nella vostra configurazione utente.
2. Incollate la configurazione qui sotto in mcp e salvate.
3. Avviate OpenCode. Se l’accesso non parte automaticamente, eseguite opencode mcp auth dealdesk. Accedete con agenthouse, scegliete almeno un progetto DealDesk e consentite l’accesso.
4. Avviate una nuova conversazione e verificate la connessione elencando le schede DealDesk aperte.

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

OpenClaw collega MCP remoto tramite Streamable HTTP. Impostate auth su oauth. L’accesso salva le credenziali sul Gateway.

1. Aprite la Control UI in Settings → MCP e scegliete Add server. In alternativa, incollate la configurazione qui sotto nella configurazione OpenClaw.
2. Nome: dealdesk. Transport: Streamable HTTP. URL: l’indirizzo qui sotto. Auth: oauth.
3. Scegliete Sign in oppure eseguite openclaw mcp login dealdesk. Accedete con agenthouse, scegliete almeno un progetto DealDesk e consentite l’accesso.
4. Verificate la connessione con openclaw mcp doctor dealdesk --probe e elencando le schede DealDesk aperte.

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

Hermes Agent (Nous Research) supporta MCP remoto con OAuth 2.1 e PKCE. I token restano in ~/.hermes/mcp-tokens/, non nel file di configurazione.

1. Eseguite hermes mcp add --url https://api.agenthouse.org/mcp/dealdesk --auth oauth dealdesk. Oppure incollate il blocco qui sotto in ~/.hermes/config.yaml.
2. Se l’accesso non parte automaticamente, eseguite hermes mcp login dealdesk.
3. Accedete con agenthouse, scegliete almeno un progetto DealDesk e consentite l’accesso.
4. Riavviate Hermes oppure eseguite /reload-mcp. Verificate la connessione elencando le schede DealDesk aperte.

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

1. Se il vostro client supporta server MCP remoti con OAuth, aggiungete l’URL del server e accedete con agenthouse.
2. Altrimenti avviate il bridge DealDesk locale con il comando qui sotto. È necessario Node.js 20 o successivo.
3. Sostituite ahk_YOUR_PROJECT_API_KEY e YOUR_PROJECT_ID con i vostri valori oppure impostateli come variabili d’ambiente nel vostro 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 una chiave API di progetto in Gestione accessi → Chiavi API. La chiave viene mostrata una sola volta. Sostituite i segnaposto (YOUR_PROJECT_ID e, se presente, ahk_YOUR_PROJECT_API_KEY) con i vostri valori. Non incollate mai la chiave in una chat. Apri gestione accessi