Vythos MCP

npx add-mcp 'https://api.vythos.tech/api/mcp/sse'

Tudo o que você precisa está na página Ferramentas de IA no Vythos: o endereço do servidor, uma chave e um trecho de código pronto para cada ferramenta. Copie de lá em vez daqui — o endereço é exibido para você em vez de ser codificado, então é sempre o correto para o seu espaço de trabalho.

Duas maneiras de provar quem você é

Claude Desktop faz login com sua conta Vythos (OAuth): sem chave para colar ou manter segura. Todo o resto usa uma chave enviada como cabeçalho Authorization: Bearer …. De qualquer forma, a conexão carrega o acesso da pessoa a quem pertence.

Claude Desktop

1. No Vythos, abra Ferramentas de IA e copie o endereço do servidor.
2. No Claude Desktop: Configurações → Conectores → Adicionar → Conector personalizado.
3. Cole o endereço e escolha Conectar.
4. Seu navegador abre. Faça login no Vythos e aprove. A conexão pode ler seu Playbook, pesquisar sua memória e registrar resultados, exatamente como a página de aprovação lista; ela não pode alterar uma regra.

Nenhuma chave necessária. A conexão aparece na página Ferramentas de IA, onde você pode ver quando foi usada pela última vez.

Claude Code

1. No Vythos, Ferramentas de IA → Nova chave, dê um rótulo como Claude Code e copie tanto a chave quanto o endereço.
2. Execute o comando mostrado na página:

claude mcp add --transport http vythos <server-address> \
  --header "Authorization: Bearer <your-key>"

Use --transport http. O endereço termina em /sse por razões históricas, mas o servidor fala Streamable HTTP — --transport sse falha ao conectar.

Cursor

Crie ou edite .cursor/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "vythos": {
      "url": "<server-address>",
      "headers": { "Authorization": "Bearer <your-key>" }
    }
  }
}

Windsurf

Configurações → MCP, ou edite ~/.codeium/windsurf/mcp_config.json com o mesmo formato da configuração do Cursor acima.

Qualquer outro cliente MCP

Três valores, e todo cliente MCP precisa deles:

URL do servidor	Da página Ferramentas de IA
Transporte	Streamable HTTP (POST)
Cabeçalho de autenticação	Authorization: Bearer <your-key>

A maioria das ferramentas que anunciam suporte a MCP funciona com isso. As listadas na página Ferramentas de IA são as que nós mesmos conectamos.

Verifique se funcionou

Peça à sua ferramenta para fazer algo que precise das suas regras:

"Usando Vythos, quais são nossos termos de pagamento padrão?"

ou, melhor, uma tarefa real:

"Elabore uma proposta de projeto para a Acme para um retentor de três meses. Obtenha as regras do Vythos primeiro e verifique o rascunho antes de mostrá-lo para mim."

Você deve ver a ferramenta chamar o Vythos, citar números que correspondam ao seu Playbook e — na verificação — relatar nada encontrado ou nomear a regra que uma linha quebra.

Se não conectar

Sintoma	Causa provável
O cliente não consegue alcançar o servidor	Verifique se o endereço é exatamente o da página Ferramentas de IA, incluindo /sse
Conecta, mas toda chamada é rejeitada	A chave está errada, revogada ou sem o prefixo Bearer
Claude Code conecta e depois cai	Você usou --transport sse. Use --transport http
Conecta, mas não retorna nada útil	Verifique o acesso de quem possui a chave. Uma categoria definida como sem acesso nunca é enviada
O endereço continua mudando	Seu espaço de trabalho está apontado para um endereço de desenvolvimento temporário. A página Ferramentas de IA informa quando é o caso — peça-nos o endereço permanente

Chaves e higiene

Uma chave é mostrada uma vez, quando você a cria. Guarde-a onde guarda outros segredos, uma chave por ferramenta, e revogue qualquer uma sobre a qual você não tenha certeza — a revogação tem efeito imediato. Veja Chaves.