--- title: "Conectar Payhawk a tu Asistente de IA - Payhawk Help Center" slug: "connecting-payhawk-mcp" description: "Conecta el MCP de Payhawk a Claude, ChatGPT, Cursor, Notion y otros Asistentes de IA compatibles con la URL del servidor MCP y tus credenciales de Payhawk." updated: 2026-10-28T14:33:11Z published: 2026-10-28T14:33:11Z canonical: "payhawk.com/connecting-payhawk-mcp" --- > ## Documentation Index > Fetch the complete documentation index at: https://payhawk.com/help/llms.txt > Use this file to discover all available pages before exploring further. # Conectar Payhawk a tu Asistente de IA El MCP de Payhawk conecta tu cuenta de Payhawk con tu Asistente de IA para que puedas consultar tus datos de Payhawk en tiempo real y realizar acciones en el Asistente de IA que ya utilizas, como Claude, ChatGPT o Cursor, con tus credenciales y permisos. ## Antes de empezar Para conectar el MCP de Payhawk, necesitas: - Una cuenta de Payhawk activa. Inicia sesión con las mismas credenciales que utilizas para acceder al [portal web de Payhawk](http://portal.payhawk.com/). - La URL del servidor MCP de Payhawk ([https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp), también disponible en las siguientes secciones). Cada usuario inicia sesión con sus propias credenciales de Payhawk, por lo que conserva sus propios permisos de Payhawk. La sesión se mantiene abierta mientras utilizas la conexión. Tienes que volver a iniciar sesión tras 7 días sin uso y, como máximo, cada 30 días. ## Asistentes de IA compatibles En la siguiente tabla se indican los Asistentes de IA compatibles con el MCP de Payhawk: | Asistente de IA | Desarrollador | Información útil | | --- | --- | --- | | [Claude](/help/es/connecting-payhawk-mcp#connecting-to-claude) | Anthropic | Web y aplicaciones para ordenador y dispositivos móviles. En un plan Team o Enterprise, solo un propietario de Claude puede añadir Payhawk. | | [Claude Code](/help/es/connecting-payhawk-mcp#connecting-to-claude-code) | Anthropic | Se configura en un terminal. | | [ChatGPT](/help/es/connecting-payhawk-mcp#connecting-to-chatgpt) | OpenAI | Aplicación para ordenador, en todos los planes, incluido Free. | | [Codex CLI](/help/es/connecting-payhawk-mcp#connecting-to-codex) | OpenAI | Se configura en un terminal. Para usar la aplicación de Codex para ordenador, sigue los pasos de ChatGPT. Los componentes de la interfaz se muestran como texto. | | [Cursor](/help/es/connecting-payhawk-mcp#connecting-to-cursor) | Anysphere | Se configura en tu archivo `mcp.json`. | | [Aplicación GitHub Copilot](/help/es/connecting-payhawk-mcp#connecting-to-the-github-copilot-app) | GitHub | | | [GitHub Copilot en VS Code](/help/es/connecting-payhawk-mcp#connecting-to-github-copilot-in-vs-code) | GitHub | Se configura desde la Command Palette (paleta de comandos). | | [Microsoft Copilot Studio](/help/es/connecting-payhawk-mcp#connecting-to-microsoft-copilot-studio) | Microsoft | | | [Microsoft 365 Copilot](/help/es/connecting-payhawk-mcp#connecting-to-microsoft-365-copilot) | Microsoft | Un administrador de Microsoft 365 tiene que aprobar el agente de Payhawk. | | [Langdock](/help/es/connecting-payhawk-mcp#connecting-to-langdock) | Langdock | | | [Notion](/help/es/connecting-payhawk-mcp#connecting-to-notion) | Notion | | | [Dust](/help/es/connecting-payhawk-mcp#connecting-to-dust) | Dust | | > [!TIP] > Payhawk solo acepta inicios de sesión desde los Asistentes de IA de la tabla. En cualquier otra aplicación, el inicio de sesión falla con un error que menciona `host-not-allowed` o «The client redirect URI is not allowed» («No se permite el URI de redirección del cliente»). Para solicitar compatibilidad con otra aplicación, ponte en contacto con el equipo de soporte de Payhawk en [support@payhawk.com](mailto:support@payhawk.com). ## Conectar con Claude Claude es compatible con el MCP de Payhawk en la web y en las aplicaciones para ordenador y dispositivos móviles. En primer lugar, comprueba si puedes añadir conectores por tu cuenta. - Los conectores personalizados funcionan con todos los planes de Claude (Free, Pro, Max, Team y Enterprise; Free permite añadir uno), por lo que el plan no suele ser el impedimento. - Con una cuenta personal Free, Pro o Max, puedes añadir Payhawk por tu cuenta. - En un espacio de trabajo Team o Enterprise, solo un propietario de Claude puede añadir un conector personalizado, así que pídele al propietario de tu espacio de trabajo que añada Payhawk una vez y, después, conéctate al conector de forma individual. Ser administrador de Payhawk no supone ninguna diferencia en este caso, ya que se trata de un permiso de Claude, no de Payhawk. Si lo añades por tu cuenta (Free, Pro o Max): 1. En la aplicación de Claude para ordenador, ve a **Configuración** > **Conectores**. 2. Haz clic en **Añadir conector personalizado**. 3. Introduce un nombre, por ejemplo, **Payhawk**, y la URL del servidor MCP de Payhawk, [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Deja las opciones que Claude marca como **Detectado**: **Iniciar sesión ahora** en **Autenticación** y **Registrar automáticamente** en **Cliente OAuth**. 5. Inicia sesión con tus credenciales de Payhawk cuando se te solicite. También puedes añadir Payhawk desde la aplicación móvil de Claude, en la misma pantalla. Si lo añade el propietario de tu espacio de trabajo de Claude (Team o Enterprise): 1. El propietario debe ir a **Configuración de la organización** > **Conectores**, hacer clic en **Añadir**, colocar el cursor sobre **Personalizado** y seleccionar **Web**. 2. El propietario debe pegar la URL del servidor MCP de Payhawk, [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp), y hacer clic en **Añadir**. 3. El resto de los usuarios deben ir a **Configuración** > **Conectores**, buscar Payhawk, hacer clic en **Conectar** e iniciar sesión con sus propias credenciales de Payhawk. Cada usuario inicia sesión con su propia cuenta, por lo que conserva sus propios permisos de Payhawk. Payhawk aparecerá ahora entre tus herramientas de Claude. ## Conectar con Claude Code Para conectar Payhawk con Claude Code: 1. En un terminal, ejecuta `claude mcp add --transport http payhawk https://mcp.payhawk.com/mcp`. Para que Payhawk esté disponible en todos tus proyectos y no solo en el actual, añade `--scope user`. 2. Inicia Claude Code y escribe `/mcp`. 3. Selecciona **payhawk** y sigue los pasos en tu navegador para iniciar sesión con tus credenciales de Payhawk. También puedes iniciar sesión desde el terminal con `claude mcp login payhawk` y cerrarla con `claude mcp logout payhawk`. Las ejecuciones no interactivas (`claude -p`) no pueden completar el inicio de sesión, así que inicia sesión primero una vez desde una sesión interactiva. Si eliminas el servidor con `claude mcp remove payhawk`, también se elimina tu inicio de sesión guardado. ## Conectar con ChatGPT El MCP de Payhawk funciona en la aplicación de ChatGPT para ordenador, también con el plan Free. Para conectar Payhawk con ChatGPT: 1. En la aplicación de ChatGPT para ordenador, ve a **Configuración** > **Plugins** > **Añadir** > **Añadir servidor MCP**. 2. Introduce un nombre, por ejemplo, **Payhawk**. 3. Elige **Streamable HTTP** y pega la URL del servidor MCP de Payhawk, [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Inicia sesión con tus credenciales de Payhawk cuando se te solicite. ## Conectar con Codex La aplicación de Codex para ordenador ahora forma parte de la aplicación de ChatGPT para ordenador. Para usar Payhawk allí, sigue los pasos de ChatGPT. Para conectar Payhawk con Codex CLI (la herramienta de línea de comandos): 1. En un terminal, ejecuta `codex mcp add payhawk --url https://mcp.payhawk.com/mcp`. 2. Ejecuta `codex mcp login payhawk`. 3. Inicia sesión con tus credenciales de Payhawk en la ventana del navegador que se abre. Los componentes de la interfaz de usuario, como los widgets de vuelos o aprobaciones, no se muestran en Codex. Recibirás la respuesta en formato de texto. ## Conectar con Cursor Para conectar Payhawk con Cursor: 1. En Cursor, ve a **Customize** (Personalizar) > **MCPs** > **New MCP Server** (Nuevo servidor MCP). Cursor abre tu archivo `mcp.json`. 2. Añade Payhawk dentro de `"mcpServers"`, como en el siguiente ejemplo. Si el archivo ya incluye otros servidores, añade una coma después de la entrada anterior. ```plaintext {  "mcpServers": {    "payhawk": { "url": "https://mcp.payhawk.com/mcp" }  } } ``` 3. Guarda el archivo y vuelve a **Customize** (Personalizar) > **MCPs**. 4. En **Needs Attention** (Requiere atención), haz clic en **Authenticate** (Autenticar) junto a Payhawk e inicia sesión con tus credenciales de Payhawk. Payhawk aparecerá ahora en **Connected** (Conectado). ## Conectar con la aplicación GitHub Copilot Para conectar Payhawk con la aplicación GitHub Copilot: 1. En la aplicación GitHub Copilot, ve a **Customize** (Personalizar) > **Installed** (Instalado). 2. Junto a **MCP Servers** (Servidores MCP), haz clic en **Add server** (Añadir servidor) > **Add custom server** (Añadir servidor personalizado). 3. En **Server name** (Nombre del servidor), introduce un nombre, por ejemplo, **payhawk**. 4. En **Server type** (Tipo de servidor), elige **HTTP**. 5. En **URL**, pega la URL del servidor MCP de Payhawk, [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 6. Deja vacíos **Headers** (Encabezados), **OAuth Client ID** (ID de cliente OAuth) y **Timeout** (Tiempo de espera), y haz clic en **Add server** (Añadir servidor). 7. Inicia sesión con tus credenciales de Payhawk cuando se te solicite. ## Conectar con GitHub Copilot en VS Code Para conectar Payhawk con GitHub Copilot en VS Code: 1. En VS Code, abre la Command Palette (paleta de comandos) con `Cmd+Shift+P` en Mac o `Ctrl+Shift+P` en Windows y ejecuta **MCP: Add Server** (MCP: Añadir servidor). 2. Elige **HTTP**. 3. Pega la URL del servidor MCP de Payhawk, [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Introduce un nombre, por ejemplo, **Payhawk Customer MCP**. 5. Elige **Global** o **Workspace** (Área de trabajo). VS Code añade Payhawk a tu archivo `mcp-config.json`, como en el siguiente ejemplo: ```plaintext {  "mcpServers": {    "Payhawk Customer MCP": {      "type": "http",      "url": "https://mcp.payhawk.com/mcp",      "tools": ["*"]    }  } } ``` ## Conectar con Microsoft Copilot Studio Para conectar Payhawk con Microsoft Copilot Studio: 1. En Copilot Studio, ve a **Tools** (Herramientas) y haz clic en **New tool** (Nueva herramienta). 2. Selecciona **Model Context Protocol**. 3. Rellena los campos obligatorios: un nombre en **Server name** (Nombre del servidor), por ejemplo, **Payhawk MCP**, una descripción en **Server description** (Descripción del servidor) y la URL del servidor MCP de Payhawk, [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp), en **Server URL** (URL del servidor). 4. En **Authentication** (Autenticación), elige **OAuth 2.0** y, en **Type** (Tipo), elige **Dynamic discovery** (Detección dinámica). 5. Haz clic en **Create** (Crear). Payhawk aparecerá ahora en tu lista de herramientas. ## Conectar con Microsoft 365 Copilot Microsoft 365 Copilot no tiene ninguna opción para añadir un conector. En su lugar, empaquetas Payhawk como un agente en VS Code y lo publicas en tu organización. ### Qué necesitas Para publicar Payhawk en Microsoft 365 Copilot, necesitas: - Una cuenta profesional de Microsoft 365. Las cuentas personales de Microsoft no funcionan. - Un administrador global o un administrador de Teams de Microsoft 365 para los pasos de aprobación. - Visual Studio Code con la extensión **Microsoft 365 Agents Toolkit**, versión 6.12.0 o posterior. ### Permitir aplicaciones personalizadas (una vez, lo hace un administrador) En el [Centro de administración de Teams](https://admin.teams.microsoft.com): 1. Ve a **Teams apps** (Aplicaciones de Teams) > **Setup policies** (Directivas de configuración) > **Global (Org-wide default)** (Global (predeterminado para toda la organización)), activa **Upload custom apps** (Cargar aplicaciones personalizadas) y haz clic en **Save** (Guardar). 2. Ve a **Teams apps** (Aplicaciones de Teams) > **Manage apps** (Administrar aplicaciones) > **Actions** (Acciones) > **Org-wide app settings** (Configuración de aplicaciones de toda la organización), activa **Let users interact with custom apps in preview** (Permitir que los usuarios interactúen con aplicaciones personalizadas en versión preliminar) y haz clic en **Save** (Guardar). Los cambios pueden tardar hasta 24 horas en aplicarse. ### Crear el agente en VS Code Para crear el agente de Payhawk: 1. En VS Code, haz clic en el icono de **Microsoft 365 Agents Toolkit** en la barra izquierda. 2. Haz clic en **Create a New Agent/App** (Crear un nuevo agente o aplicación) > **Declarative Agent** (Agente declarativo) > **Add an Action** (Añadir una acción) > **Start with an MCP Server** (Empezar con un servidor MCP). 3. Como URL del servidor, introduce [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Para la autenticación, selecciona **OAuth (with dynamic registration)** (OAuth (con registro dinámico)). 5. Elige una carpeta para el proyecto y ponle un nombre al agente, por ejemplo, **Payhawk**. 6. En la nueva ventana de VS Code, haz clic en **Trust** (Confiar). Si no viste el aviso, haz clic en **Restricted Mode** (Modo restringido) en la barra de estado y, después, en **Trust** (Confiar). ### Establecer el nombre y la descripción Establece un nombre y una descripción reales para el agente. Si omites este paso, los usuarios verán texto de marcador de posición y el sufijo «dev» en el nombre. 1. En `appPackage/manifest.json`, sustituye los valores de marcador de posición de `developer.name`, `name.full`, `description.short` y `description.full`. 2. En `appPackage/declarativeAgent.json`, sustituye `description`. 3. Crea el archivo `env/.env.prod` con el siguiente contenido: ```plaintext TEAMSFX_ENV=prod APP_NAME_SUFFIX= ``` ### Publicar el agente Para enviar el agente a tu administrador para que lo apruebe: 1. En el panel **Lifecycle** (Ciclo de vida), haz clic en **Provision** (Aprovisionar) y elige **prod**. 2. Haz clic en **Publish** (Publicar) y elige **prod**. ### Aprobar el agente (lo hace un administrador) En el [Centro de administración de Microsoft 365](https://admin.microsoft.com): 1. Ve a **Agents** (Agentes) > **All agents** (Todos los agentes) > **Requests** (Solicitudes). 2. Abre el agente de Payhawk y haz clic en **Publish to store** (Publicar en la tienda). 3. En **Select users or groups who can install the agent** (Seleccionar los usuarios o grupos que pueden instalar el agente), elige **All users** (Todos los usuarios) o grupos específicos. También puedes elegir quién tendrá el agente preinstalado en su barra lateral. 4. Acepta la directiva de seguridad predeterminada, revisa los permisos y haz clic en **Publish** (Publicar). Si el paso de la directiva de seguridad no termina de cargar, aprueba el agente desde el Centro de administración de Teams: ve a **Teams apps** (Aplicaciones de Teams) > **Manage apps** (Administrar aplicaciones), busca el agente de Payhawk y publícalo o permítelo. Después, los usuarios abren Payhawk en **Agents** (Agentes), en la barra lateral de Copilot. La primera vez que preguntan algo, hacen clic en **Sign in** (Iniciar sesión), inician sesión con sus credenciales de Payhawk y aprueban el acceso. ## Conectar con Langdock Para conectar Payhawk con Langdock: 1. En Langdock, ve a **Integrations** (Integraciones) > **Create** (Crear) > **Integration** (Integración). 2. Selecciona **Connect remote MCP** (Conectar MCP remoto). 3. En **Server URL** (URL del servidor), pega la URL del servidor MCP de Payhawk, [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. En **Authentication method** (Método de autenticación), elige **OAuth 2.0 (Dynamic Client Registration)** (OAuth 2.0 (registro dinámico de clientes)). 5. Inicia sesión con tus credenciales de Payhawk cuando se te solicite. ## Conectar con Notion Para conectar Payhawk con Notion: 1. En Notion, ve a **Settings** (Configuración) > **Connections** (Conexiones). 2. Haz clic en **+ Add connection** (+ Añadir conexión) > **Custom MCP connection** (Conexión MCP personalizada). 3. En **MCP server URL** (URL del servidor MCP), introduce la URL del servidor MCP de Payhawk, [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp), y, en **Name** (Nombre), introduce un nombre, por ejemplo, **Payhawk**. 4. En **Authentication** (Autenticación), elige **OAuth**. 5. Haz clic en **Connect** (Conectar). Notion muestra un aviso de que no ha revisado este servidor, algo normal en los servidores personalizados. 6. Cuando Notion te lleve a Payhawk, inicia sesión con tus credenciales de Payhawk. ## Conectar con Dust Para conectar Payhawk con Dust: 1. En Dust, ve a **Spaces** (Espacios) > **Tools** (Herramientas) y haz clic en **Add tools** (Añadir herramientas). 2. Haz clic en **Add MCP server** (Añadir servidor MCP). 3. En **URL**, pega la URL del servidor MCP de Payhawk, [https://mcp.payhawk.com/mcp](https://mcp.payhawk.com/mcp). 4. Deja **Authentication** (Autenticación) en **Automatic** (Automático) y haz clic en **Save** (Guardar). Payhawk aparecerá ahora en tu lista de herramientas. ## Después de conectar Payhawk con tu Asistente de IA Una vez establecida la conexión, puedes consultar información sobre gastos, facturas, transacciones con tarjeta, proveedores y presupuestos. También puedes pedir a tu Asistente de IA que realice acciones, como volver a contabilizar gastos, realizar aprobaciones, bloquear tarjetas y crear solicitudes. Antes de aplicar cualquier cambio, se muestra una vista previa y se espera a que lo confirmes expresamente. Para obtener información más práctica, consulta el artículo [Sacar el máximo partido al MCP de Payhawk](/help/payhawk-mcp-questions-and-actions).