Ir al contenido principal
agenthouse Academia Habilitación IA Overview DealDesk Digital Customer Assistant HumanProof Decision Intelligence NewsRoom Anonymizer Agentic Business Agents agenthouse OS Services Desarrolladores AI Credits Deutsch English Italiano Français Español 日本語

Pegue estas instrucciones en su asistente de IA. Leerá la guía de instalación oficial y le guiará durante la conexión.

Instrucciones para su asistente
Configure la conexión con agenthouse DealDesk.

Siga la guía: https://agenthouse.org/es/dealdesk/connect.md
Guía oficial del plugin: https://github.com/agenthouse-org/dealdesk-plugin/blob/main/install-for-agents.md
URL del servidor MCP: https://api.agenthouse.org/mcp/dealdesk

Use el inicio de sesión con agenthouse (OAuth). No empiece con una clave API salvo que este host no pueda abrir un navegador.
No me pida que pegue mi clave API en este chat. Indíqueme dónde introducirla yo mismo.
Al terminar, enumere mis tarjetas de DealDesk abiertas para confirmar la conexión.
Responsabilidad sobre los datos de clientesLas herramientas de DealDesk pueden transmitir datos de clientes y oportunidades al asistente de IA conectado, a sus proveedores de modelos y a otras herramientas de la misma conversación. Usted decide qué asistentes, modelos y herramientas autoriza y es responsable del tratamiento lícito de esos datos.
ChatGPT Claude Gemini GitHub Copilot Cursor, Claude Desktop, Codex Open WebUI OpenCode OpenClaw Hermes Agent Otros

ChatGPT (web y escritorio)

Inicio de sesión con agenthouse
  1. Abra la configuración de ChatGPT y vaya al área de conectores (aplicaciones). En espacios de trabajo empresariales, es posible que un administrador deba permitir primero los conectores personalizados (modo desarrollador).
  2. Cree un conector nuevo llamado DealDesk, pegue la URL del servidor de abajo y elija OAuth como autenticación.
  3. Inicie sesión con agenthouse, elija su proyecto DealDesk y permita el acceso.
  4. Inicie un chat nuevo y active DealDesk en el menú de herramientas.
URL del servidor
https://api.agenthouse.org/mcp/dealdesk

Claude (claude.ai y aplicaciones de Claude)

Inicio de sesión con agenthouse
  1. Abra la configuración de Claude y vaya a Conectores. En los planes Team y Enterprise, un propietario añade los conectores personalizados para la organización.
  2. Añada un conector personalizado llamado DealDesk y pegue la URL del servidor de abajo.
  3. Seleccione Conectar, inicie sesión con agenthouse, elija su proyecto DealDesk y permita el acceso.
  4. En un chat, active DealDesk desde el menú de herramientas.
URL del servidor
https://api.agenthouse.org/mcp/dealdesk

Gemini CLI

Clave API de proyecto

Gemini CLI se conecta a través del puente local de DealDesk. En la aplicación web de Gemini, las aplicaciones MCP personalizadas solo están disponibles por ahora en Gemini Spark para cuentas personales que cumplan los requisitos. Si tiene acceso, añada allí la URL del servidor que aparece en «Otros».

  1. Instale Node.js 20 o posterior y Gemini CLI.
  2. Cree una clave API de proyecto y guárdela en su equipo como variable de entorno AGENTHOUSE_API_KEY.
  3. Añada la configuración de abajo a ~/.gemini/settings.json (o .gemini/settings.json en un proyecto) y sustituya YOUR_PROJECT_ID.
  4. Reinicie Gemini CLI y ejecute /mcp list. DealDesk debería aparecer como conectado.
settings.json
{
  "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"
      }
    }
  }
}

Cree una clave API de proyecto en Gestión de accesos → Claves API. La clave solo se muestra una vez. Sustituya los marcadores (YOUR_PROJECT_ID y, si aparece, ahk_YOUR_PROJECT_API_KEY) por sus propios valores. Nunca pegue la clave en un chat. Abrir gestión de accesos

GitHub Copilot en VS Code

Inicio de sesión con agenthouse

VS Code 1.101 o posterior admite MCP remoto con OAuth. Tras guardar, elija Auth encima de la entrada del servidor e inicie sesión con agenthouse.

  1. Abra VS Code 1.101 o posterior con GitHub Copilot.
  2. Ejecute el comando «MCP: Open User Configuration» o cree .vscode/mcp.json en su proyecto.
  3. Pegue la configuración de abajo, guarde y elija Auth. Inicie sesión con agenthouse, elija al menos un proyecto DealDesk y permita el acceso.
  4. Abra Copilot Chat en modo agente y active las herramientas de DealDesk.
mcp.json
{
  "servers": {
    "dealdesk": {
      "type": "http",
      "url": "https://api.agenthouse.org/mcp/dealdesk"
    }
  }
}

Cursor, Claude Desktop y Codex

Inicio de sesión con agenthouse

El inicio de sesión con agenthouse es el camino previsto para estos asistentes. Una clave API de proyecto solo hace falta cuando no se puede abrir un navegador (por ejemplo en CI).

  1. Cursor: instale el plugin DealDesk o añada la URL del servidor de abajo como MCP remoto. Claude Desktop y Codex: instale Node.js 20 o posterior.
  2. Claude Desktop: abra claude_desktop_config.json. Codex: abra su configuración MCP. Pegue la configuración MCP local de abajo.
  3. Complete el inicio de sesión con agenthouse, elija al menos un proyecto DealDesk y permita el acceso. No cree una clave API para este camino.
  4. Inicie un chat nuevo y compruebe la conexión enumerando sus tarjetas DealDesk abiertas.
URL del servidor
https://api.agenthouse.org/mcp/dealdesk
Configuración MCP
{
  "mcpServers": {
    "dealdesk": {
      "command": "npx",
      "args": [
        "-y",
        "dealdesk-plugin"
      ]
    }
  }
}

Open WebUI

Inicio de sesión con agenthouse

Requiere Open WebUI 0.6.31 o posterior. Solo los administradores pueden añadir servidores MCP. Elija OAuth 2.1, no Bearer ni OAuth 2.1 (Static). No establezca DealDesk como herramienta predeterminada de un modelo. En Docker, defina un WEBUI_SECRET_KEY estable o el inicio de sesión se pierde tras un reinicio.

  1. Abra Settings → Admin → Integrations. En External Tool Servers, elija Add Connection.
  2. Establezca Type en MCP (Streamable HTTP). Pegue la URL del servidor de abajo. Auth: OAuth 2.1. Guarde y elija Register Client si aparece.
  3. Inicie sesión con agenthouse, elija al menos un proyecto DealDesk y permita el acceso.
  4. Abra un chat y active DealDesk en + → Integrations → Tools. No lo establezca como herramienta predeterminada.
URL del servidor
https://api.agenthouse.org/mcp/dealdesk

OpenCode

Inicio de sesión con agenthouse

OpenCode detecta OAuth en MCP remoto automáticamente y registra el cliente con DCR. No establezca oauth en false.

  1. Abra opencode.json u opencode.jsonc en el proyecto o en su configuración de usuario.
  2. Pegue la configuración de abajo en mcp y guarde.
  3. Inicie OpenCode. Si el inicio de sesión no arranca solo, ejecute opencode mcp auth dealdesk. Inicie sesión con agenthouse, elija al menos un proyecto DealDesk y permita el acceso.
  4. Inicie una conversación nueva y compruebe la conexión enumerando sus tarjetas DealDesk abiertas.
opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "dealdesk": {
      "type": "remote",
      "url": "https://api.agenthouse.org/mcp/dealdesk"
    }
  }
}

OpenClaw

Inicio de sesión con agenthouse

OpenClaw conecta MCP remoto por Streamable HTTP. Establezca auth en oauth. El inicio de sesión guarda las credenciales en el Gateway.

  1. Abra la Control UI en Settings → MCP y elija Add server. Como alternativa, pegue la configuración de abajo en la configuración de OpenClaw.
  2. Nombre: dealdesk. Transport: Streamable HTTP. URL: la dirección de abajo. Auth: oauth.
  3. Elija Sign in o ejecute openclaw mcp login dealdesk. Inicie sesión con agenthouse, elija al menos un proyecto DealDesk y permita el acceso.
  4. Compruebe la conexión con openclaw mcp doctor dealdesk --probe y enumerando sus tarjetas DealDesk abiertas.
Configuración MCP
{
  "mcp": {
    "servers": {
      "dealdesk": {
        "url": "https://api.agenthouse.org/mcp/dealdesk",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

Hermes Agent

Inicio de sesión con agenthouse

Hermes Agent (Nous Research) admite MCP remoto con OAuth 2.1 y PKCE. Los tokens se guardan en ~/.hermes/mcp-tokens/, no en el archivo de configuración.

  1. Ejecute hermes mcp add --url https://api.agenthouse.org/mcp/dealdesk --auth oauth dealdesk. O pegue el bloque de abajo en ~/.hermes/config.yaml.
  2. Si el inicio de sesión no arranca solo, ejecute hermes mcp login dealdesk.
  3. Inicie sesión con agenthouse, elija al menos un proyecto DealDesk y permita el acceso.
  4. Reinicie Hermes o ejecute /reload-mcp. Compruebe la conexión enumerando sus tarjetas DealDesk abiertas.
config.yaml
mcp_servers:
  dealdesk:
    url: "https://api.agenthouse.org/mcp/dealdesk"
    auth: oauth

Otros clientes MCP

Inicio de sesión o clave API
  1. Si su cliente admite servidores MCP remotos con OAuth, añada la URL del servidor e inicie sesión con agenthouse.
  2. De lo contrario, inicie el puente local de DealDesk con el comando de abajo. Requiere Node.js 20 o posterior.
  3. Sustituya ahk_YOUR_PROJECT_API_KEY y YOUR_PROJECT_ID por sus valores o defínalos como variables de entorno en su cliente.
URL del servidor
https://api.agenthouse.org/mcp/dealdesk
Comando
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

Cree una clave API de proyecto en Gestión de accesos → Claves API. La clave solo se muestra una vez. Sustituya los marcadores (YOUR_PROJECT_ID y, si aparece, ahk_YOUR_PROJECT_API_KEY) por sus propios valores. Nunca pegue la clave en un chat. Abrir gestión de accesos

Comprobar la conexión

Inicie un chat nuevo y pregunte a su asistente:

Comprobar la conexión
Enumere mis tarjetas de DealDesk abiertas.

agenthouse Privacidad Aviso legal