Servidores MCP

O que voce vai aprender

• O que e MCP e como ele conecta assistentes de IA de codificacao ao AutoTalk
• Como configurar MCP no Codex e Claude Code
• Quais ferramentas estao disponiveis e como usa-las

O AutoTalk expoe um servidor MCP (Model Context Protocol) que da aos assistentes de IA de codificacao acesso direto aos seus schemas Dynadata, documentos de exemplo, operacoes CRUD, testes de Workflow e mais. Isso permite que ferramentas como Codex e Claude Code entendam seus modelos de dados e construam agentes/workflows sem que voce precise copiar e colar schemas.

Pre-requisitos

Voce precisa de um token de API para autenticar com o servidor MCP. Veja Tokens de API para saber como criar um.

O endpoint MCP e:

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

Configuracao do Codex

Adicione isso ao seu ~/.codex/config.toml:

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

aviso

Use http_headers, nao headers. O Codex requer a chave http_headers para servidores MCP baseados em URL.

Configuracao do Claude Code

Adicione isso ao .mcp.json do seu projeto ou ao ~/.claude.json global sob a chave mcpServers:

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

Ferramentas disponiveis

O servidor fornece 17 ferramentas agrupadas em tres categorias:

Ferramentas de schema (10)

Ferramenta	Descricao
list_dynadata_types	Lista os tipos de modelo disponiveis (agentes, workflows, clientes, etc.)
get_model_definition	Retorna definicoes de campos, tipos e restricoes de um modelo
get_model_json_schema	Retorna o JSON Schema para um tipo de modelo
get_model_relationships	Mostra como os modelos referenciam uns aos outros
list_action_types	Lista todos os tipos de acao de Workflow/agente
get_action_definition	Retorna a definicao completa da acao com campos e saidas
get_cel_reference	Retorna variaveis e funcoes CEL por contexto
validate_document	Valida um documento contra o schema do modelo
get_guide	Retorna guias estilo cookbook para construir agentes e workflows
search_example_documents	Pesquisa documentos de exemplo selecionados para padroes reutilizaveis

Ferramentas de dados (5)

Ferramenta	Descricao
create_document	Cria um novo documento no banco de dados
get_document	Le um documento por tipo e ID
update_document	Atualiza um documento existente
delete_document	Exclui de forma suave (tombstone) um documento
test_workflow	Testa um Workflow em memoria sem persistir nada

Ferramentas de funcao (2)

Ferramenta	Descricao
list_functions	Lista funcoes executaveis do lado do servidor para um tipo de modelo
execute_function	Executa uma funcao em um documento ou colecao

Dicas de uso

• Comece com list_dynadata_types para descobrir modelos disponiveis, depois use get_model_definition para detalhes dos campos.
• Use search_example_documents para encontrar padroes reutilizaveis antes de construir agentes ou workflows do zero.
• Use validate_document para verificar seu documento antes de cria-lo com create_document.
• Use test_workflow para iteracao rapida — ele executa workflows em memoria e limpa automaticamente.
• Para documentos grandes, valide secoes especificas usando o parametro fields ou tipos embutidos.

Proximos passos

• Tokens de API — Crie e gerencie tokens de API
• Webhooks — Configure notificacoes de eventos de saida