Servidores MCP

Lo que aprenderas

• Que es MCP y como conecta asistentes de IA de programacion con AutoTalk
• Como configurar MCP en Codex y Claude Code
• Que herramientas estan disponibles y como usarlas

AutoTalk expone un servidor MCP (Model Context Protocol) que da a los asistentes de IA de programacion acceso directo a tus schemas Dynadata, documentos de ejemplo, operaciones CRUD, pruebas de Workflow y mas. Esto permite que herramientas como Codex y Claude Code comprendan tus modelos de datos y construyan agentes/workflows sin que necesites copiar y pegar schemas.

Requisitos previos

Necesitas un token de API para autenticarte con el servidor MCP. Consulta Tokens de API para saber como crear uno.

El endpoint MCP es:

https://api.autotalk.io/v1/mcp/dynadata

Configuracion de Codex

Agrega esto a tu ~/.codex/config.toml:

[mcp_servers.autotalk]
url = "https://api.autotalk.io/v1/mcp/dynadata"
http_headers = { "x-api-key" = "sk-YOUR-API-KEY" }

aviso

Usa http_headers, no headers. Codex requiere la clave http_headers para servidores MCP basados en URL.

Configuracion de Claude Code

Agrega esto al .mcp.json de tu proyecto o al ~/.claude.json global bajo la clave mcpServers:

{
  "mcpServers": {
    "autotalk": {
      "url": "https://api.autotalk.io/v1/mcp/dynadata",
      "headers": {
        "x-api-key": "sk-YOUR-API-KEY"
      }
    }
  }
}

Herramientas disponibles

El servidor proporciona 17 herramientas agrupadas en tres categorias:

Herramientas de schema (10)

Herramienta	Descripcion
list_dynadata_types	Lista los tipos de modelo disponibles (agentes, workflows, clientes, etc.)
get_model_definition	Retorna definiciones de campos, tipos y restricciones de un modelo
get_model_json_schema	Retorna el JSON Schema para un tipo de modelo
get_model_relationships	Muestra como los modelos se referencian entre si
list_action_types	Lista todos los tipos de accion de Workflow/agente
get_action_definition	Retorna la definicion completa de la accion con campos y salidas
get_cel_reference	Retorna variables y funciones CEL por contexto
validate_document	Valida un documento contra el schema del modelo
get_guide	Retorna guias estilo cookbook para construir agentes y workflows
search_example_documents	Busca documentos de ejemplo seleccionados para patrones reutilizables

Herramientas de datos (5)

Herramienta	Descripcion
create_document	Crea un nuevo documento en la base de datos
get_document	Lee un documento por tipo e ID
update_document	Actualiza un documento existente
delete_document	Elimina de forma suave (tombstone) un documento
test_workflow	Prueba un Workflow en memoria sin persistir nada

Herramientas de funcion (2)

Herramienta	Descripcion
list_functions	Lista funciones ejecutables del lado del servidor para un tipo de modelo
execute_function	Ejecuta una funcion en un documento o coleccion

Consejos de uso

• Comienza con list_dynadata_types para descubrir modelos disponibles, luego usa get_model_definition para detalles de los campos.
• Usa search_example_documents para encontrar patrones reutilizables antes de construir agentes o workflows desde cero.
• Usa validate_document para verificar tu documento antes de crearlo con create_document.
• Usa test_workflow para iteracion rapida — ejecuta workflows en memoria y limpia automaticamente.
• Para documentos grandes, valida secciones especificas usando el parametro fields o tipos embebidos.

Proximos pasos

• Tokens de API — Crea y gestiona tokens de API
• Webhooks — Configura notificaciones de eventos salientes