Detalhes do protocolo

Transporte

Item	Valor
Endereço	POST https://api.taitecnologia.com/mcp
Transporte	Streamable HTTP, respostas sempre em application/json
Versões do protocolo	2025-06-18, 2025-03-26
Streaming (SSE)	Não usado
Sessão (Mcp-Session-Id)	Não usada — cada requisição é independente
GET /mcp	405
Lote JSON-RPC	Não aceito
Capacidades	tools (sem resources e sem prompts)

Chamada sem SDK

# 1. initialize
curl -s https://api.taitecnologia.com/mcp \
  -H "Authorization: Bearer $TAI_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2025-06-18","capabilities":{},
        "clientInfo":{"name":"meu-agente","version":"1.0"}}}'

# 2. listar ferramentas
curl -s https://api.taitecnologia.com/mcp \
  -H "Authorization: Bearer $TAI_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# 3. chamar uma ferramenta
curl -s https://api.taitecnologia.com/mcp \
  -H "Authorization: Bearer $TAI_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
        "name":"minhas_informacoes","arguments":{}}}'

A resposta do initialize traz, em instructions, o contexto da conversa: data de hoje, quem é o usuário e as empresas da conta. Clientes que repassam as instruções ao modelo ganham respostas mais precisas sobre datas e empresas.

Erros

Há dois tipos de erro, e eles se tratam de formas diferentes:

Tipo	Quando	Formato
Erro da ferramenta	A operação falhou: parâmetro inválido, registro inexistente, sem permissão, escrita recusada	Resultado normal com isError: true e a explicação no conteúdo — feito para o modelo ler e corrigir a chamada
Erro JSON-RPC	A requisição em si está errada: método inexistente, JSON inválido, versão não suportada	Objeto error do JSON-RPC

Erros de credencial são respostas HTTP: 401 sem credencial ou com credencial inválida, vencida ou revogada; 429 acima do limite.

Limites

Limite	Valor
Requisições	120 por minuto por credencial
Escritas	10 por minuto por credencial
Falhas de autenticação	20 por minuto por IP
Tempo por ferramenta	25 segundos
Ferramentas em tools/list	até 256
Link de download de arquivo	15 minutos