Jev MCP Server (TypeSafe Jev)
Use o modelo de decisão Jev da TypeSafe a partir do Claude, ChatGPT, Cursor ou Gemini: verificações sim/não, classificação e pontuação com probabilidades em cerca de 300 ms. Servidor remoto com OAuth, uma chave criptografada compartilhada para equipe, auto-hospedável (AnythingMCP).
Servidor MCP hospedado
npx add-mcp 'https://cloud.anythingmcp.com/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Servidor MCP Jev
Conecte o Jev ao Claude, ChatGPT e Copilot: verificações sim/não, classificações e pontuações, com a probabilidade por trás de cada resposta como ferramentas MCP. Desenvolvido com AnythingMCP.
O Servidor MCP Jev oferece ao Claude, ChatGPT, Copilot e Cursor 6 ferramentas para o Jev: verificações sim/não, classificações e pontuações, com a probabilidade por trás de cada resposta. Cada ferramenta apenas lê. Ele roda no AnythingMCP: um clique no AnythingMCP Cloud, ou auto-hospedado com Docker. As credenciais são armazenadas criptografadas e cada chamada é auditada.
Última verificação: 27/09/2026 contra a API TypeSafe ao vivo (jev-1.13.0) (cada ferramenta chamada por meio de um AnythingMCP local via MCP, 27 casos diretos de API incluindo caminhos de erro, e Claude Code triando tickets em inglês e alemão pelo conector).
Adaptador sincronizado: 27/09/2026
Mantido por @keysersoft, um mantenedor do AnythingMCP. Construído sobre o AnythingMCP pela helpcode.ai.
Início rápido (AnythingMCP Cloud)
- Entre em cloud.anythingmcp.com e abra o link de instalação.
- Insira
TYPESAFE_API_KEY(veja Autenticação). - Copie a URL do seu servidor MCP em Servidores MCP e adicione-a ao seu cliente de IA (abaixo).
O AnythingMCP Cloud é o mesmo código de código aberto, operado pela helpcode.ai em Frankfurt, Alemanha.
Auto-hospedado (Docker)
Requer Docker 24+, openssl e Node 18+.
git clone https://github.com/keysersoft/jev-mcp-server.git
cd jev-mcp-server
./scripts/install.sh
install.sh grava .env com segredos novos, inicia o AnythingMCP, cria o primeiro administrador, instala o conector se TYPESAFE_API_KEY estiverem definidos em .env e cria uma chave de API MCP. Sem credenciais, ele imprime o link de instalação: http://localhost:3000/connectors/store?install=jev. Depois verifique toda a cadeia:
npm install && node scripts/smoke.mjs
Conecte Claude, ChatGPT, Copilot ou Cursor
-
Claude (claude.ai, Desktop, mobile): Personalizar → Conectores → Adicionar conector personalizado, cole a URL do seu servidor MCP e entre. O Claude conecta-se pela nuvem da Anthropic, então a URL deve ser HTTPS pública: sua URL do AnythingMCP Cloud, ou sua própria instância atrás de TLS.
-
Claude Code:
claude mcp add --transport http jev-mcp-server http://localhost:4000/mcp --header "X-API-Key: <MCP_API_KEY>" -
Cursor (
.cursor/mcp.json) e VS Code / GitHub Copilot (.vscode/mcp.json, chaveserversem vez demcpServers, além de"type": "http"):{ "mcpServers": { "jev-mcp-server": { "url": "http://localhost:4000/mcp", "headers": { "X-API-Key": "<MCP_API_KEY>" } } } } -
ChatGPT: adicione a URL HTTPS pública como um conector (app) nas configurações do ChatGPT. Uma URL
localhostnão funciona lá.
Ferramentas
6 ferramentas, geradas a partir de adapter/jev.json. As ferramentas read não podem alterar nada no sistema de origem.
| Ferramenta | O que faz | Acesso |
|---|---|---|
jev_playbook | COMEÇE AQUI: retorna, SEM chamada de API, como usar o Jev bem: qual tipo de pergunta escolher, como estruturar o estado, como escrever a pergunta, como ler… | leitura |
jev_yes_no | Pergunte ao Jev UMA pergunta sim/não sobre alguma evidência. | leitura |
jev_classify | Peça ao Jev para escolher UMA opção de um conjunto que você define (roteamento, rotulagem, intenção, triagem). | leitura |
jev_rate | Peça ao Jev para colocar a evidência em uma escala ordenada que você define (gravidade, adequação do lead, qualidade, sentimento). | leitura |
jev_ask | API Jev completa: faça VÁRIAS perguntas tipadas sobre o mesmo estado em uma chamada (respondidas em paralelo, estado cobrado uma vez). | leitura |
jev_list_models | Liste os nomes de modelos Jev que sua chave de API pode usar no campo model (aliases como jev-latest e jev-preview, com datas de lançamento). | leitura |
Exemplos de prompts
- Use o Jev para decidir quais destes tickets de suporte são urgentes e mostre a probabilidade de cada um.
- Classifique cada ticket abaixo em cobrança, técnico, vendas ou nenhum com o Jev e liste aqueles em que a confiança está abaixo de 0,6.
- Avalie estes cinco leads de 0 (sem adequação) a 3 (cliente ideal) com o Jev contra o perfil abaixo.
- Pergunte ao Jev se esta resposta responde a todas as perguntas do e-mail do cliente antes de eu enviá-la.
- Pergunte ao Jev se estes dois registros de fornecedor descrevem a mesma empresa.
- Quais destes 20 e-mails pedem reembolso? Use o Jev e me dê apenas os acima de 0,8.
Mais em examples/prompts.md.
Autenticação
O conector precisa de um valor:
| Variável | Onde encontrar |
|---|---|
TYPESAFE_API_KEY | console.typesafe.ai → crie uma chave de API |
A chave é enviada como Authorization: Bearer <key> para https://api.typesafe.ai. Na instalação, o AnythingMCP a verifica com uma chamada gratuita de GET /v1/models e depois a armazena criptografada.
Segurança
- Leitura ou escrita é sua escolha. Todas as 6 ferramentas apenas leem. Atribua o conector a um servidor MCP cuja função permita apenas as ferramentas que você deseja, e o restante fica invisível para aquele cliente.
- Credenciais são criptografadas com AES-256-GCM e nunca mostradas ao modelo.
- Mapeamento de resposta descarta ou reformata campos por ferramenta antes de chegarem ao modelo, por exemplo, dados bancários ou dados pessoais.
- Log de auditoria: cada chamada é registrada com entrada, saída, duração e status, no seu próprio banco de dados quando auto-hospedado.
- SSO, RBAC e SCIM estão incluídos na versão auto-hospedada.
FAQ
O que é o Jev?
O Jev é o primeiro modelo System One da TypeSafe. Ele não gera texto: você passa evidências (o state) e perguntas tipadas, e ele responde a cada uma com uma probabilidade sim/não, uma opção de um conjunto que você define, ou uma pontuação em níveis ordenados, com as probabilidades por trás da resposta. Em nossos testes, uma chamada levou de 220 a 430 ms.
Como uso o Jev no Claude ou ChatGPT?
Instale o conector Jev no AnythingMCP com sua chave de API TypeSafe e adicione a URL do servidor AnythingMCP ao Claude como um conector personalizado ou ao ChatGPT como um app em modo desenvolvedor. Ambos entram com OAuth, então nada precisa rodar no seu computador. Claude Code, Cursor e outros clientes usam a mesma URL com um cabeçalho de chave de API.
Quais ferramentas o conector tem?
jev_yes_no, jev_classify e jev_rate fazem uma pergunta cada com parâmetros simples; jev_ask envia várias perguntas de qualquer tipo sobre a mesma evidência em uma chamada; jev_list_models lista os modelos que sua chave pode usar; jev_playbook explica ao modelo como formular perguntas e ler as respostas, sem chamar a API.
Quanto custa?
A TypeSafe cobra o Jev por token de entrada, cerca de US$ 0,042 por milhão, e a saída é gratuita. Uma chamada com três perguntas sobre um ticket de suporte curto usou cerca de 500 tokens. O AnythingMCP em si é gratuito quando auto-hospedado.
Uma equipe pode compartilhar uma chave TypeSafe?
Sim. A chave é armazenada uma vez, criptografada, no servidor AnythingMCP. As pessoas se conectam ao servidor com seu próprio login, nunca veem a chave, e cada chamada é gravada no log de auditoria.
O Jev entende outros idiomas além do inglês?
Ele lida com eles. Tickets em alemão e italiano retornaram corretos e confiantes em nossos testes; o inglês é onde a TypeSafe relata a melhor precisão, então observe os valores de confiança para outros idiomas.
Solução de problemas
| Problema | Correção |
|---|---|
401 / 403 do fornecedor | As credenciais estão erradas ou sem direitos. Reinsira-as na página do conector; a importação executa uma chamada de teste e mostra o resultado. |
| Ferramentas ausentes no cliente de IA | O conector não está atribuído ao servidor MCP que o cliente usa. Verifique Servidores MCP e execute node scripts/smoke.mjs. |
| O host está na sua rede interna | Auto-hospede o AnythingMCP nessa rede e adicione o nome do host a SSRF_ALLOWED_HOSTS, ou o guarda de saída bloqueia a chamada. |
| Funciona localmente, falha no AnythingMCP Cloud | O sistema deve estar acessível pela internet com um certificado TLS válido. |
| Sintoma | Causa e correção |
401 em cada chamada | A chave de API está errada ou foi revogada. Crie uma nova em console.typesafe.ai e atualize TYPESAFE_API_KEY no conector. |
400 Invalid request. | Uma pergunta tem um tipo diferente de noul, choice ou score (não existe bool), ou a solicitação carrega um campo que o Jev não conhece. O resultado da ferramenta inclui uma dica que lista as formas válidas. |
422 nomeando score.criteria | Os níveis de pontuação devem ser um array, do menor para o maior, não um objeto. |
400 Too many score levels / Too many choices | Uma pontuação aceita no máximo 10 níveis e uma escolha no máximo 255 opções. |
429 ou 529 | Limite de taxa da TypeSafe ou sobrecarga temporária. O conector tenta novamente com backoff; distribua grandes lotes ao longo do tempo. |
| Uma resposta sim/não perto de 0,5 | O Jev está incerto, não dizendo "médio". Faça uma pergunta mais específica sobre a evidência em questão, ou passe mais contexto em state. |
Relacionados
- openapi-to-mcp: OpenAPI para MCP: transforme qualquer API OpenAPI/Swagger ou REST em um servidor MCP para Claude e ChatGPT. Cada endpoint uma ferramenta, sem código.
- erp-mcp-server: Servidor MCP ERP: conecte 16 ERPs (SAP, Odoo, JTL-Wawi, Xentral, weclapp, ERPNext…) ao Claude e ChatGPT. Auto-hospedado ou na nuvem.
- AnythingMCP: o servidor MCP e gateway de código aberto no qual este repositório é construído.
Licença
AGPL-3.0-only. A definição do adaptador em adapter/ vem do AnythingMCP (AGPL-3.0).