Conectar Payhawk a tu Asistente de IA

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.

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, 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.

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.

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.

4. Inicia sesión con tus credenciales de Payhawk cuando se te solicite.

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.

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.

   {
     "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).

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.

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.

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.

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:

{
  "mcpServers": {
    "Payhawk Customer MCP": {
      "type": "http",
      "url": "https://mcp.payhawk.com/mcp",
      "tools": ["*"]
    }
  }
}

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, 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.

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:

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.

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:

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:

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.

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.

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.

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, 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.

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.

4. Deja Authentication (Autenticación) en Automatic (Automático) y haz clic en Save (Guardar).

Payhawk aparecerá ahora en tu lista de herramientas.