> ## Documentation Index
> Fetch the complete documentation index at: https://strattumai.mintlify.site/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.

<Info>
  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).
</Info>

## 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:

<CardGroup cols={1}>
  <Card title="search_entity" icon="magnifying-glass" color="#6D28D9">
    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`.
  </Card>

  <Card title="get_entity_context" icon="brain" color="#6D28D9">
    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.
  </Card>

  <Card title="search_knowledge" icon="book-open" color="#6D28D9">
    Busca semântica na base de conhecimento indexada — documentos, políticas e procedimentos corporativos. Retorna os trechos mais relevantes ranqueados por similaridade.
  </Card>
</CardGroup>

## 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

<CardGroup cols={3}>
  <Card title="Claude Code" icon="terminal" href="/mcp-server/claude-code">
    Configuração via stdio — processo local, zero latência de rede.
  </Card>

  <Card title="Microsoft Copilot" icon="microsoft" href="/mcp-server/microsoft-copilot">
    Configuração via SSE — servidor HTTP remoto na porta 8005.
  </Card>

  <Card title="ChatGPT" icon="comment" href="/mcp-server/chatgpt">
    Integração via Actions e plugin personalizado.
  </Card>
</CardGroup>