Deje que su asistente configure la conexión
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
- 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).
- Cree un conector nuevo llamado DealDesk, pegue la URL del servidor de abajo y elija OAuth como autenticación.
- Inicie sesión con agenthouse, elija su proyecto DealDesk y permita el acceso.
- Inicie un chat nuevo y active DealDesk en el menú de herramientas.
https://api.agenthouse.org/mcp/dealdesk
Claude (claude.ai y aplicaciones de Claude)
Inicio de sesión con agenthouse
- 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.
- Añada un conector personalizado llamado DealDesk y pegue la URL del servidor de abajo.
- Seleccione Conectar, inicie sesión con agenthouse, elija su proyecto DealDesk y permita el acceso.
- En un chat, active DealDesk desde el menú de herramientas.
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».
- Instale Node.js 20 o posterior y Gemini CLI.
- Cree una clave API de proyecto y guárdela en su equipo como variable de entorno AGENTHOUSE_API_KEY.
- Añada la configuración de abajo a ~/.gemini/settings.json (o .gemini/settings.json en un proyecto) y sustituya YOUR_PROJECT_ID.
- Reinicie Gemini CLI y ejecute /mcp list. DealDesk debería aparecer como conectado.
{
"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.
- Abra VS Code 1.101 o posterior con GitHub Copilot.
- Ejecute el comando «MCP: Open User Configuration» o cree .vscode/mcp.json en su proyecto.
- 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.
- Abra Copilot Chat en modo agente y active las herramientas de DealDesk.
{
"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).
- 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.
- Claude Desktop: abra claude_desktop_config.json. Codex: abra su configuración MCP. Pegue la configuración MCP local de abajo.
- 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.
- Inicie un chat nuevo y compruebe la conexión enumerando sus tarjetas DealDesk abiertas.
https://api.agenthouse.org/mcp/dealdesk
{
"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.
- Abra Settings → Admin → Integrations. En External Tool Servers, elija Add Connection.
- Establezca Type en MCP (Streamable HTTP). Pegue la URL del servidor de abajo. Auth: OAuth 2.1. Guarde y elija Register Client si aparece.
- Inicie sesión con agenthouse, elija al menos un proyecto DealDesk y permita el acceso.
- Abra un chat y active DealDesk en + → Integrations → Tools. No lo establezca como herramienta predeterminada.
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.
- Abra opencode.json u opencode.jsonc en el proyecto o en su configuración de usuario.
- Pegue la configuración de abajo en mcp y guarde.
- 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.
- Inicie una conversación nueva y compruebe la conexión enumerando sus tarjetas DealDesk abiertas.
{
"$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.
- 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.
- Nombre: dealdesk. Transport: Streamable HTTP. URL: la dirección de abajo. Auth: oauth.
- Elija Sign in o ejecute openclaw mcp login dealdesk. Inicie sesión con agenthouse, elija al menos un proyecto DealDesk y permita el acceso.
- Compruebe la conexión con openclaw mcp doctor dealdesk --probe y enumerando sus tarjetas DealDesk abiertas.
{
"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.
- Ejecute hermes mcp add --url https://api.agenthouse.org/mcp/dealdesk --auth oauth dealdesk. O pegue el bloque de abajo en ~/.hermes/config.yaml.
- Si el inicio de sesión no arranca solo, ejecute hermes mcp login dealdesk.
- Inicie sesión con agenthouse, elija al menos un proyecto DealDesk y permita el acceso.
- Reinicie Hermes o ejecute /reload-mcp. Compruebe la conexión enumerando sus tarjetas DealDesk abiertas.
mcp_servers:
dealdesk:
url: "https://api.agenthouse.org/mcp/dealdesk"
auth: oauth
Otros clientes MCP
Inicio de sesión o clave API
- Si su cliente admite servidores MCP remotos con OAuth, añada la URL del servidor e inicie sesión con agenthouse.
- De lo contrario, inicie el puente local de DealDesk con el comando de abajo. Requiere Node.js 20 o posterior.
- Sustituya ahk_YOUR_PROJECT_API_KEY y YOUR_PROJECT_ID por sus valores o defínalos como variables de entorno en su cliente.
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
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:
Enumere mis tarjetas de DealDesk abiertas.