> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strattum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Conecte Claude Code, ChatGPT e Microsoft Copilot diretamente à memória e ao conhecimento da strattum.ai via Model Context Protocol.

O **MCP Server** da strattum.ai implementa o [Model Context Protocol (MCP)](https://modelcontextprotocol.io) — padrão aberto criado pela Anthropic para expor ferramentas e dados a agentes de IA de forma padronizada.

Com ele, qualquer cliente MCP (Claude Code, Microsoft Copilot, IDEs como Cursor e Windsurf) pode consultar **Memory** e **Knowledge** da strattum.ai diretamente durante uma conversa, sem necessidade de código customizado.

> [!NOTE]
>
> O MCP Server atua como adaptador entre os clientes de IA e as APIs internas da plataforma. Ele não armazena dados — apenas roteia chamadas para a Memory API (porta 8002) e a Knowledge API (porta 8003).

## Por que passar pelo MCP Server

O modelo de IA líder hoje vira legado em meses. Manter o contexto da empresa fora do modelo transforma a troca de LLM em decisão de configuração.

| Propriedade | O que significa |
| - | - |
| **Protocolo aberto** | MCP é adotado por Anthropic, OpenAI, Microsoft e Google. O mesmo endpoint atende Claude, GPT, Gemini e Copilot, sem integração por modelo. |
| **Contexto fora do modelo** | Memory, Knowledge e Skills vivem na plataforma. Trocar de LLM não exige reescrever integração. |
| **Governança em cada chamada** | Cada tool call é autenticada e registrada no Audit Log, independente de qual modelo a originou. |
| **Multi-modelo simultâneo** | Times diferentes operam modelos diferentes contra o mesmo contexto, sem duplicar pipeline nem fragmentar o grafo. |

## Ferramentas disponíveis

O servidor expõe três ferramentas MCP:

> **search\_entity**
>
> Busca entidades em Memory por nome, e-mail, telefone, `external_id` ou texto livre. Use esta ferramenta para encontrar o `entity_id` de um cliente ou empresa antes de chamar `get_entity_context`.

> **get\_entity\_context**
>
> Retorna o contexto completo de uma entidade: perfil consolidado, timeline de eventos recentes e relações de 1 grau no grafo. O resultado já vem formatado em Markdown, pronto para consumo pelo agente.

> **search\_knowledge**
>
> Busca semântica na base de conhecimento indexada — documentos, políticas e procedimentos corporativos. Retorna os trechos mais relevantes ranqueados por similaridade.

## Transportes suportados

O MCP Server opera em dois modos, selecionados pela variável `MCP_TRANSPORT`:

| Modo | Variável | Uso típico |
| - | - | - |
| `stdio` (padrão local) | `MCP_TRANSPORT=stdio` | Claude Code, Cursor, Windsurf — processo local |
| `sse` (HTTP/SSE) | `MCP_TRANSPORT=sse` | Microsoft Copilot, agentes remotos — porta 8005 |

## Variáveis de ambiente

| Variável | Padrão | Descrição |
| - | - | - |
| `MEMORY_API_URL` | `http://localhost:8002` | URL base da Memory API |
| `KNOWLEDGE_API_URL` | `http://localhost:8003` | URL base da Knowledge API |
| `MCP_API_KEY` | *(vazio)* | Bearer token para o modo SSE. Se não definido, autenticação desabilitada |
| `MCP_HOST` | `0.0.0.0` | Host de bind do servidor SSE |
| `MCP_PORT` | `8005` | Porta do servidor SSE |
| `HTTP_TIMEOUT` | `30` | Timeout (segundos) para chamadas às APIs internas |
| `LOG_LEVEL` | `INFO` | Nível de log (`DEBUG`, `INFO`, `WARNING`, `ERROR`) |

***

## Próximos passos

> **[Claude Code](https://docs.strattum.ai/mcp-server/claude-code.md)**
>
> Configuração via stdio — processo local, zero latência de rede.

> **[Microsoft Copilot](https://docs.strattum.ai/mcp-server/microsoft-copilot.md)**
>
> Configuração via SSE — servidor HTTP remoto na porta 8005.

> **[ChatGPT](https://docs.strattum.ai/mcp-server/chatgpt.md)**
>
> Integração via Actions e plugin personalizado.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.