En esta página
Conecta tu asistente
Conectar Koywe tiene dos pasos: agregas el servidor en tu asistente y después lo autorizas desde Koywe. No hay claves que copiar: inicias sesión con tu usuario de siempre.
Antes de empezar
- Un usuario de Koywe con acceso a la organización que quieres conectar.
- Un asistente compatible con MCP que permita agregar servidores remotos (a veces se llaman conectores personalizados). Según tu plan, puede que quien administra el asistente en tu empresa tenga que habilitarlo.
| Entorno | Dirección del servidor |
|---|---|
| Producción (por ahora, solo consultas) | https://mcp.koywe.com/mcp |
| Sandbox (consultas y operaciones de prueba) | https://mcp-sandbox.koywe.com/mcp |
Puedes conectar los dos a la vez con nombres distintos, por ejemplo koywe y koywe-sandbox.
1. Agrega Koywe en tu asistente
La forma más rápida: pídeselo a tu asistente
Muchos asistentes y agentes (por ejemplo, Claude Code o Cursor) pueden agregar conectores por su cuenta. Pásale la dirección y pídele que agregue Koywe:
Agrega Koywe como conector MCP:
https://mcp.koywe.com/mcp
Igual tendrás que autorizar la conexión en Koywe (paso 2). Si tu asistente no ve el conector, reinícialo: en Claude Desktop o Claude Code a veces hace falta.
Agregarlo a mano
Si tu asistente no puede hacerlo solo, en casi todos el proceso es el mismo:
- Agrega un servidor MCP (o conector) personalizado.
- Pega la dirección del servidor.
- Inicia sesión en Koywe cuando el asistente te lo pida.
Abre el ejemplo de tu asistente. Los menús cambian con frecuencia: si no encuentras una opción, busca «conectores» o «MCP» en su configuración.
Claude (claude.ai y Claude Desktop)
Ve a Configuración → Conectores, elige Agregar conector personalizado, pega https://mcp.koywe.com/mcp y pulsa Conectar. El conector también aparece en Claude Desktop y en la app móvil con la misma cuenta.
ChatGPT
En Configuración → Apps y conectores, crea un conector con la dirección https://mcp.koywe.com/mcp y autenticación OAuth. Autoriza en Koywe cuando ChatGPT te lo pida y, cuando termine de leer las herramientas, pulsa Crear. Según tu plan, puede que primero tengas que activar el modo desarrollador en la configuración avanzada, o que lo habilite quien administra ChatGPT en tu empresa.
Claude Code
claude mcp add --transport http koywe https://mcp.koywe.com/mcpDespués, escribe /mcp, elige koywe y luego Authenticate.
Cursor
Agrega esto en ~/.cursor/mcp.json, abre Settings → MCP (o Tools & MCP), busca koywe y pulsa Login.
{
"mcpServers": {
"koywe": { "url": "https://mcp.koywe.com/mcp" }
}
}VS Code
Agrega esto en .vscode/mcp.json y pulsa Start sobre el servidor.
{
"servers": {
"koywe": { "type": "http", "url": "https://mcp.koywe.com/mcp" }
}
}¿Usas Grok u otro asistente? Sigue los tres pasos de arriba con la dirección del servidor; si su configuración no muestra la opción para agregar un servidor MCP remoto, todavía no es compatible.
2. Autoriza la conexión en Koywe
Tu asistente abre una página de Koywe titulada Conectar un asistente de IA.
Inicia sesión
Entra con tu usuario de Koywe.
Elige qué compartir
- Organización: una por conexión.
- Merchants (tus empresas): Específicos (hasta 25) o Todos, que incluye también las que se agreguen después.
- Permisos: Consultar información va siempre incluido; lo demás es opcional. Lo que saca dinero o agrega una cuenta queda esperando hasta que lo confirmes en Koywe. Revisa qué permite cada uno.
Autoriza
Pulsa Autorizar. Koywe te lleva de vuelta a tu asistente y la conexión queda lista.
Si no fuiste tú quien inició la conexión, pulsa Cancelar. Es normal ver Cliente no verificado o Vuelve a un programa de tu computador si acabas de conectar desde ChatGPT o un editor. Nadie de Koywe te pedirá que autorices un asistente.
3. Prueba la conexión
Pregúntale algo a tu asistente, por ejemplo:
- «¿Cuánto saldo tengo en cada empresa?»
- «¿Qué tengo pendiente de aprobar?»
Si responde con tus datos, ya está conectado. Si no, revisa Problemas comunes.
Cuánto dura la conexión
La conexión dura 24 horas desde que la autorizas; después, repites el paso 2. Cada conexión es para una organización: si trabajas con varias, agrega el servidor una vez por cada una, con nombres distintos. Para ver o cerrar tus conexiones, revisa Aplicaciones conectadas.