Conectar herramientas de IA con MCP

Ody tiene un servidor MCP (Protocolo de Contexto de Modelo) incorporado en https://api.ody.co/v1/mcp — agréguelo a ChatGPT, Claude, Cursor o cualquier cliente MCP con una clave API, y el asistente podrá gestionar contactos, trabajar sus conversaciones, buscar mensajes, enviar mensajes de texto, comprar números de teléfono, registrar mensajes de texto 10DLC, realizar llamadas de IA salientes y configurar su agente de IA en su espacio de trabajo.

Antes de empezar

Necesita una clave API — consulte Obtenga su clave API de Ody. Para un asistente que solo debe leer, cree la clave solo con los alcances de lectura. Para experimentar sin enviar mensajes de texto reales, use una clave ody_test_… — consulte Construya de forma segura con el modo de prueba.

MCP está incluido en todos los planes, comenzando con Starter.

Paso a paso

1. Haga clic en Configuración en la barra lateral, luego en API para desarrolladores.

2. Desplácese hasta la tarjeta Conectar a ChatGPT y Claude. Muestra el punto final de MCP — https://api.ody.co/v1/mcp — con un botón Copiar, y una configuración de cliente lista para pegar.

3. En la configuración de MCP/conector de su herramienta de IA, agregue un servidor usando esta configuración (con su clave real):

{
  "mcpServers": {
    "ody": {
      "url": "https://api.ody.co/v1/mcp",
      "headers": { "Authorization": "Bearer ody_live_…" }
    }
  }
}

4. Pregúntele al asistente algo como "dame un resumen de mi espacio de trabajo de Ody" para confirmar la conexión.

Qué puede hacer el asistente

El servidor MCP expone veinte herramientas, cada una protegida por el mismo alcance que utiliza su punto final REST:

Herramienta	Qué hace	Alcance requerido
list_contacts	Listar o buscar sus contactos	contacts:read
create_contact	Agregar un contacto	contacts:write
update_contact	Actualizar el nombre, empresa, teléfono o correo electrónico de un contacto	contacts:write
delete_contact	Eliminar permanentemente un contacto	contacts:write
list_conversations	Listar conversaciones abiertas/finalizadas	conversations:read
get_conversation	Leer un hilo completo	conversations:read
set_conversation_status	Marcar una conversación como abierta o finalizada	conversations:write
search_messages	Buscar cuerpos de mensajes, transcripciones de buzón de voz y notas de llamadas	conversations:read
workspace_summary	Resumen: recuento de contactos, recuentos de abiertos/finalizados, total de no leídos, volumen de 7 días	conversations:read
wait_for_message	Esperar (hasta 25 s) un nuevo mensaje entrante en una conversación	conversations:read
send_message	Enviar un SMS (a una conversación o a un número de teléfono)	messages:send
list_numbers	Listar los números de su espacio de trabajo	numbers:read
search_numbers	Buscar números de teléfono que puede comprar	numbers:manage
buy_number	Comprar un número — facturado como una compra dentro de la aplicación	numbers:manage
get_messaging_status	Verificar el estado de registro de mensajes de texto 10DLC	numbers:manage
submit_10dlc_registration	Registrar su negocio + campaña 10DLC (facturado)	numbers:manage
place_call	Hacer que su agente de IA publicado realice una llamada saliente	calls:place
get_agent	Leer la configuración y el uso de créditos de su agente de IA	agent:manage
configure_agent	Actualizar la configuración del agente; pase publish: true para activarlo	agent:manage
connect_agent_to_number	Enrutar uno de sus números al agente de IA	agent:manage

Si a la clave le falta un alcance, esa herramienta simplemente no se le ofrece al asistente — por lo tanto, una clave de solo lectura produce un asistente genuinamente de solo lectura. Todo se ejecuta con los permisos del miembro que creó la clave, solo en ese espacio de trabajo.

Dos cosas que vale la pena saber:

• wait_for_message permite que un asistente mantenga una conversación SMS en vivo: envía un mensaje de texto con send_message, espera hasta 25 segundos la respuesta y responde — llamando a la herramienta nuevamente si el tiempo de espera expira.
• Las herramientas de números, 10DLC, llamadas y agentes son la misma superficie de "Teléfono de Agente" que la API REST — la misma facturación, las mismas reglas, y puede tomar el control en la aplicación en cualquier momento. Consulte Comprar números y registrar mensajes de texto a través de la API y Realizar llamadas de IA y administrar Astra a través de la API.

Con una clave de prueba, send_message registra un mensaje simulado, buy_number y place_call simulan (nada comprado o marcado), la publicación de agentes se simula, y submit_10dlc_registration se archiva en modo de prueba — sin tarifa, sin envío al registro.

Artículos relacionados

• Obtenga su clave API de Ody
• Construya de forma segura con el modo de prueba
• Descripción general y autenticación de la API

---