Saltar al contenido principal

Conecta tu app de IA

Todas las apps siguen el mismo flujo:

  1. Agrega un servidor MCP personalizado (o "conector") con la URL https://mcp.fonema.ai/mcp.
  2. La app abre una ventana de inicio de sesión de Fonema. Entra con tu cuenta del dashboard.
  3. Revisa la pantalla Autorizar acceso y haz clic en Autorizar.
  4. Regresas a la app y las herramientas de Fonema quedan listas para usarse.

Los nombres de los menús en apps de terceros cambian con frecuencia. Si algún paso no coincide con lo que ves, busca "Conectores", "Servidores MCP" o "Integraciones" en la configuración de la app.

Claude (claude.ai y Claude Desktop)​

  1. Abre Settings → Connectors.
  2. Haz clic en Add custom connector.
  3. Escribe un nombre, por ejemplo Fonema, y la URL https://mcp.fonema.ai/mcp.
  4. Haz clic en Add, luego en Connect, y completa el inicio de sesión de Fonema.

En los planes Team y Enterprise, puede que un owner de la organización tenga que agregar el conector primero.

ChatGPT​

  1. Abre Settings → Apps & Connectors.
  2. En Advanced settings, activa Developer mode (necesario para conectores personalizados que hacen cambios, como startCall, createAgent y updateAgent).
  3. Haz clic en Create, escribe Fonema como nombre y https://mcp.fonema.ai/mcp como URL, y elige OAuth como autenticación.
  4. Haz clic en Create y completa el inicio de sesión de Fonema.

Claude Code​

Ejecuta:

claude mcp add --transport http fonema https://mcp.fonema.ai/mcp

Después abre Claude Code, ejecuta /mcp, selecciona fonema y elige Authenticate.

Cursor​

Agrega Fonema a ~/.cursor/mcp.json (o a .cursor/mcp.json en un proyecto):

{
  "mcpServers": {
    "fonema": {
      "url": "https://mcp.fonema.ai/mcp"
    }
  }
}

Cursor muestra un botón Needs login junto al servidor. Haz clic y completa el inicio de sesión de Fonema.

VS Code (GitHub Copilot)​

Agrega Fonema a .vscode/mcp.json:

{
  "servers": {
    "fonema": {
      "type": "http",
      "url": "https://mcp.fonema.ai/mcp"
    }
  }
}

Haz clic en Start arriba de la entrada del servidor y completa el inicio de sesión de Fonema.

Otros clientes MCP​

Cualquier cliente compatible con Streamable HTTP y OAuth 2.1 puede conectarse. Apúntalo a https://mcp.fonema.ai/mcp; descubre el servidor de autorización automáticamente. El servidor no guarda sesión y solo acepta solicitudes POST.

La pantalla de autorización​

Después de iniciar sesión, Fonema muestra la app que pide acceso, la empresa a la que accederá y la cuenta con la que iniciaste sesión. Revísalos y haz clic en Autorizar, o en Denegar para cancelar.

  • Si no has iniciado sesión, primero te lleva a la página de login y después te regresa.
  • Si tu empresa exige verificación en dos pasos y aún no la configuras, te pide configurarla antes de continuar.
  • La solicitud expira después de 10 minutos. Si ves Esta solicitud ha expirado, regresa a la app y vuelve a iniciar la conexión.

Administrar aplicaciones conectadas​

Para ver o quitar las apps conectadas a tu cuenta:

  1. Abre Configuración → Aplicaciones conectadas en el dashboard.

  2. Cada fila muestra la app, la empresa, cuándo se conectó y cuándo se usó por última vez.

  3. Haz clic en Revocar para desconectar una app. Pierde el acceso de inmediato y tendrá que autorizarse de nuevo para reconectarse.

Si conectas la misma app otra vez, se reemplaza la conexión anterior, así que cada app aparece una sola vez.

Mantenerse conectado​

La app renueva su acceso automáticamente en segundo plano. Solo tienes que iniciar sesión de nuevo si:

  • Revocas la app en Aplicaciones conectadas.
  • La app no se usa durante 30 días.
  • Tu usuario se elimina o se mueve a otra empresa.

Solución de problemas​

ProblemaQué hacer
Las herramientas de Fonema no aparecen después de conectarDesconecta y vuelve a conectar, y abre un chat nuevo.
Las cuentas de staff no pueden autorizar aplicaciones externasInicia sesión con una cuenta de cliente en lugar de una cuenta de staff de Fonema.
No aparece createAgent o updateAgentSolo los administradores tienen estas herramientas. Pide a un administrador de tu empresa que cambie tu rol.
Too many calls started from this connectionstartCall permite 10 llamadas cada 10 minutos por conexión. Espera e inténtalo de nuevo, o usa la API de llamadas para llamadas masivas.
Too many requestsCada conexión puede hacer 20 solicitudes cada 10 segundos. Espera unos segundos y vuelve a intentar.