Skip to main content

​
Conceito

MCP Servers (Model Context Protocol) são servidores externos que expõem ferramentas e recursos para que os agentes da Timely.ai possam executar ações no mundo real durante uma conversa. Em vez de o agente apenas responder com texto, ele pode usar ferramentas do MCP para consultar um banco de dados, criar um evento no calendário, buscar um pedido no e-commerce, enviar um email ou qualquer outra ação que o servidor MCP suporte. O protocolo MCP é um padrão aberto — qualquer servidor compatível pode ser conectado a um agente Timely. Você pode usar servidores públicos disponíveis na comunidade ou desenvolver o seu próprio para integrar sistemas internos da sua empresa.

​
Como funciona a integração

cliente envia mensagem
    │
    ▼
agente IA processa e decide usar uma tool
    │
    ▼
Timely.ai chama o MCP Server com os parâmetros da tool
    │
    ▼
MCP Server executa a ação e retorna o resultado
    │
    ▼
agente incorpora o resultado na resposta ao cliente

​
Ciclo de vida de um MCP Server

adicionar servidor (URL + configuração)
    │
    ▼
conectar → Timely faz handshake com o servidor
    │
    ▼
listar tools disponíveis
    │
    ▼
ativar tools específicas no agente
    │
    ├── sincronizar tools (atualizar lista)
    │
    ├── desativar tools específicas
    │
    └── desconectar / deletar

​
Campos principais

CampoTipoDescrição
idstring (UUID)ID único do MCP Server no workspace
agent_idstring (UUID)Agente ao qual está conectado
namestringNome descritivo do servidor
urlstringURL do endpoint MCP (SSE ou HTTP)
transportenumsse | http
statusenumconnected | disconnected | error
auth_typeenumnone | bearer | api_key
auth_tokenstringToken de autenticação (write-only)
tools_countnumberQuantidade de tools disponíveis no servidor
active_toolsarrayLista de slugs das tools ativadas no agente
created_atstringISO 8601 de adição ao workspace

​
Campos de uma Tool

CampoTipoDescrição
slugstringIdentificador único da tool no servidor
namestringNome legível da tool
descriptionstringO que a tool faz (usado pelo LLM para decidir quando usá-la)
parametersobjectJSON Schema dos parâmetros da tool
activebooleanSe a tool está ativada para o agente

​
Endpoints disponíveis

Consulte a barra lateral à esquerda para a lista completa de endpoints deste grupo. Cada endpoint tem sua própria página com schema de request/response, exemplos em cURL/JS/Python e playground interativo.

​
Próximos passos

Primeira requisição

Se você ainda não fez sua primeira chamada, comece por aqui.