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)

  1. Entre em cloud.anythingmcp.com e abra o link de instalação.
  2. Insira TYPESAFE_API_KEY (veja Autenticação).
  3. 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, chave servers em vez de mcpServers, 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 localhost nã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.

FerramentaO que fazAcesso
jev_playbookCOMEÇ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_noPergunte ao Jev UMA pergunta sim/não sobre alguma evidência.leitura
jev_classifyPeça ao Jev para escolher UMA opção de um conjunto que você define (roteamento, rotulagem, intenção, triagem).leitura
jev_ratePeça ao Jev para colocar a evidência em uma escala ordenada que você define (gravidade, adequação do lead, qualidade, sentimento).leitura
jev_askAPI 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_modelsListe 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ávelOnde encontrar
TYPESAFE_API_KEYconsole.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

ProblemaCorreção
401 / 403 do fornecedorAs 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 IAO 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 internaAuto-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 CloudO sistema deve estar acessível pela internet com um certificado TLS válido.
SintomaCausa e correção
401 em cada chamadaA 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.criteriaOs 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 choicesUma pontuação aceita no máximo 10 níveis e uma escolha no máximo 255 opções.
429 ou 529Limite 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,5O 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).