Guía para desarrolladores

Servidor MCP o clave de API: cómo debe conectarse tu IA a FoxEra Calls.

Ambos métodos le dan a tu asistente de IA o a tu código las mismas herramientas y las mismas reglas de seguridad. La elección correcta depende de si es una persona la que chatea o es código el que se ejecuta.

Dos formas de conectarse, un solo conjunto de reglas

FoxEra Calls ofrece dos métodos de conexión para asistentes de IA e integraciones de desarrolladores:

  • Servidor MCP — un endpoint MCP remoto que usa HTTP en streaming y OAuth 2.1. Tu asistente se conecta a él como a cualquier otro servidor MCP.
  • API REST con clave bearer — una API HTTP estándar descrita en OpenAPI 3.1. Tu código envía solicitudes con un token bearer fxk_....

Ambos métodos exponen las mismas capacidades: gestión de contactos, creación y aprobación de campañas, transcripciones, grabaciones, informes, horario de llamadas, selección de agente y edición de guion. Ambos aplican las mismas reglas de seguridad: número confirmado, aprobación por separado, acceso limitado y registro completo. La diferencia está en cómo se establece la conexión y quién la controla.

Cuándo usar el servidor MCP

Usa el servidor MCP cuando una persona interactúa con un asistente de IA en una ventana de chat y quiere que el asistente gestione su cuenta de FoxEra en su nombre. Esto encaja con:

  • ChatGPT, Claude, Cursor — añade el servidor MCP remoto en https://app.foxera.co.uk/mcp, inicia sesión y pulsa Permitir. El asistente puede entonces añadir contactos, previsualizar campañas y hacer llamadas tras tu aprobación, todo desde el chat.
  • Cualquier asistente que admita MCP remoto — la conexión es HTTP en streaming estándar con OAuth 2.1, así que cualquier cliente compatible puede usarla.

La vía MCP es ideal para fundadores y equipos pequeños que ya usan un asistente de IA a diario y quieren gestionar las llamadas en frío desde el mismo chat que usan para todo lo demás. Sin código que escribir, nada que instalar.

Cuándo usar una clave de API

Usa una clave de API bearer cuando tu propio código, un script o una plataforma de automatización necesita llamar a FoxEra mediante programación. Esto encaja con:

  • Integraciones de CRM — envía contactos nuevos desde tu CRM a FoxEra y recupera los resultados automáticamente.
  • Plataformas de automatización — activa una campaña desde n8n, Make o un webhook de Zapier cuando entra un contacto nuevo en tu proceso.
  • GPT Actions — importa la especificación OpenAPI 3.1 en un GPT personalizado. La URL de la especificación es todo lo que necesitas configurar.
  • Agentes personalizados — construye un agente que se ejecute sin supervisión, investigue prospectos, los añada y prepare una campaña para tu aprobación por la mañana.

Genera una clave en tu configuración para desarrolladores. Cada clave está limitada a un espacio de trabajo y puede revocarse al instante.

Cómo funciona el modelo de seguridad en cada caso

Ambos métodos de conexión aplican las mismas reglas de seguridad del lado del servidor:

  • Número confirmado — la previsualización de la campaña debe reconocerse antes de la aprobación, ya venga de una llamada a herramienta MCP o de una solicitud a la API.
  • Aprobación por separado — crear y aprobar una campaña son dos pasos distintos. Ningún método permite combinarlos.
  • Horario de llamadas — las llamadas solo se realizan dentro de tu horario configurado, independientemente de cuándo se envió la aprobación.
  • Acceso limitado — una sesión MCP está vinculada a tu concesión OAuth; una clave de API está vinculada a tu espacio de trabajo. Ninguna puede acceder a los datos de otro cliente.
  • Revocación — cambiar tu contraseña desconecta todas las sesiones MCP. Revocar una clave de API detiene todo el acceso desde esa clave al instante.

Lee el desglose completo de las medidas de seguridad para agentes de IA en llamadas salientes.

¿Puedes usar ambos a la vez?

Sí. Muchas configuraciones usan los dos métodos para partes distintas del flujo de trabajo:

  • Tu asistente de IA usa el servidor MCP para el trabajo interactivo: añadir algunos contactos desde la conversación, previsualizar una campaña, leer resultados.
  • Tu backend usa una clave de API para operaciones masivas: sincronizar cientos de contactos desde un CRM durante la noche, extraer informes diarios a un panel.

Ambos métodos comparten los mismos datos de cuenta subyacentes. Un contacto añadido a través de la API aparece en el siguiente listado de tu asistente, y una campaña aprobada a través del servidor MCP aparece en un informe de la API. No hay conflicto ni duplicación.

Si no estás seguro de por dónde empezar, el servidor MCP es más rápido de configurar (tres pasos, sin código). Puedes añadir una clave de API más tarde cuando necesites acceso mediante programación. Consulta llamadas con IA de pago por uso para ver cómo funciona el precio con cualquiera de los dos métodos.

Costes

Ambos métodos de conexión son gratis de usar. Solo pagas por las llamadas que se conectan, desde 12p por minuto conectado, sin suscripción ni cuota de plataforma. Las cuentas nuevas empiezan con £7 de crédito gratis para llamadas.

No hay diferencia en el precio de las llamadas entre el servidor MCP y la API. Ya sea que tu asistente apruebe una campaña mediante MCP o tu código la apruebe mediante la API, la tarifa por minuto es la misma. Usa la calculadora de costes para estimar una campaña antes de empezar.

Preguntas frecuentes

¿Es el servidor MCP más difícil de configurar que una clave de API?

No, es más fácil. Pega la URL en tu asistente, inicia sesión y pulsa Permitir. Una clave de API requiere generar la clave, guardarla de forma segura y escribir tú mismo las solicitudes HTTP o importar la especificación OpenAPI.

¿Tienen las conexiones MCP y de clave de API reglas de seguridad distintas?

No. Ambas aplican número confirmado, aprobación por separado, horario de llamadas, acceso limitado y registro completo. Las reglas están del lado del servidor y se aplican a cada método de conexión.

¿Puedo cambiar de MCP a clave de API más tarde?

Sí. Puedes añadir o eliminar cualquiera de los dos métodos de conexión en cualquier momento. Ambos comparten los mismos datos de cuenta, así que no se pierde nada al cambiar o usar los dos.

¿Cuánto cuesta?

Ambos métodos son gratis para conectar. Solo pagas por los minutos de llamada conectados, desde 12p por minuto conectado. Las cuentas nuevas reciben £7 de crédito gratis para llamadas.

Empieza gratis con £7 de crédito para llamadas