MCP Servers

MCP (Model Context Protocol) Servers permitem que seus agentes acessem ferramentas e dados externos.

O que são MCP Servers?

MCP Servers são servidores que expõem ferramentas (tools) que seus agentes podem usar para executar ações no mundo real, como buscar dados, enviar emails ou integrar com sistemas externos.

Como funciona

1. O agente recebe uma mensagem
2. Decide qual ferramenta usar
3. Chama o MCP Server
4. Recebe o resultado
5. Continua a conversa

Criando um MCP Server

Via interface

1. Acesse MCP Servers no menu
2. Clique em Novo MCP Server
3. Configure URL e ferramentas

Via API

typescript
const mcpServer = await client.mcpServers.create({
  name: 'CRM Integration',
  description: 'Integração com o CRM da empresa',
  url: 'https://mcp.example.com',
  apiKey: 'your-mcp-api-key',
  tools: [
    {
      name: 'search_customers',
      description: 'Busca clientes no CRM',
      parameters: {
        type: 'object',
        properties: {
          query: { type: 'string' },
          limit: { type: 'number' }
        }
      }
    },
    {
      name: 'create_ticket',
      description: 'Cria um ticket de suporte',
      parameters: {
        type: 'object',
        properties: {
          title: { type: 'string' },
          description: { type: 'string' },
          priority: { type: 'string' }
        }
      }
    }
  ]
});

Vinculando ao agente

typescript
await client.agents.update({
  id: 'agent-id',
  mcpServers: ['mcp-server-id']
});

Ferramentas disponíveis

Cada MCP Server pode expor múltiplas ferramentas:

typescript
const tools = await client.mcpServers.listTools({
  mcpServerId: 'mcp-server-id'
});

Logs e debugging

typescript
const logs = await client.mcpServers.logs({
  mcpServerId: 'mcp-server-id',
  limit: 100
});