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) — 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.

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

Configuração via stdio — processo local, zero latência de rede.

Microsoft Copilot

Configuração via SSE — servidor HTTP remoto na porta 8005.

ChatGPT

Integração via Actions e plugin personalizado.