Fidensa MCP Server

Verifique pontuações de confiança, pesquise capacidades certificadas, compare lado a lado, verifique artefatos assinados.

GitHubExperimente este MCPPatrocinado

Documentação

@fidensa/mcp-server

Servidor MCP para Fidensa -- a autoridade independente de certificação de capacidades de IA.

Dá ao seu agente de IA acesso estruturado aos dados de certificação da Fidensa através do Model Context Protocol. Verifique pontuações de confiança, pesquise alternativas certificadas, compare capacidades lado a lado, verifique artefatos assinados, confira a integridade de arquivos e relate experiências de execução -- tudo por meio de chamadas de ferramentas MCP.

A Fidensa certifica servidores MCP, habilidades, arquivos de regras de agente, hooks, subagentes e plugins.

Primeiros Passos

1. Instalação

npm install -g @fidensa/mcp-server

2. Verifique se funciona

Várias ferramentas funcionam sem chave de API (check_certification, search_capabilities, verify_file e report_experience). Inicie o servidor e confirme que ele se conecta à API de produção:

fidensa-mcp-server

Você deve ver:

[fidensa] MCP server started (stdio transport)
[fidensa] No FIDENSA_API_KEY set — check_certification, search_capabilities, verify_file, and report_experience available. Set FIDENSA_API_KEY for full access.

Pressione Ctrl+C para parar.

3. Obtenha uma chave de API (opcional, gratuita)

As ferramentas restantes (get_contract, compare_capabilities, verify_artifact) exigem uma chave de API gratuita. Uma chave de API também dá a report_experience limites de taxa mais altos. Registre uma:

curl -X POST https://fidensa.com/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"display_name": "My Agent", "email": "you@example.com"}'

Ou no PowerShell:

Invoke-RestMethod -Uri "https://fidensa.com/v1/keys" -Method Post -ContentType "application/json" -Body '{"display_name": "My Agent", "email": "you@example.com"}'

A resposta contém sua chave de API (prefixada com fid_). Armazene-a com segurança -- ela é exibida apenas uma vez.

4. Adicione ao seu agente

Escolha sua plataforma e adicione a configuração do servidor MCP:

Claude Desktop / Claude Code

{
  "mcpServers": {
    "fidensa": {
      "command": "npx",
      "args": ["@fidensa/mcp-server"],
      "env": {
        "FIDENSA_API_KEY": "fid_your_key_here"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "fidensa": {
      "command": "npx",
      "args": ["@fidensa/mcp-server"],
      "env": {
        "FIDENSA_API_KEY": "fid_your_key_here"
      }
    }
  }
}

Windsurf / VS Code

{
  "servers": {
    "fidensa": {
      "type": "stdio",
      "command": "npx",
      "args": ["@fidensa/mcp-server"],
      "env": {
        "FIDENSA_API_KEY": "fid_your_key_here"
      }
    }
  }
}

Omita a linha FIDENSA_API_KEY se você precisar apenas das ferramentas de nível aberto.

Dica do Claude Desktop: Acesse o arquivo de configuração via Configurações → Desenvolvedor → Editar Config. Após salvar, saia completamente e reabra o Claude Desktop (clique com o botão direito no ícone da bandeja do sistema e selecione Sair — apenas fechar a janela não é suficiente).

Ferramentas

Ferramenta	Autenticação	Descrição
`check_certification`	Nenhuma	Verificação rápida de confiança -- status, pontuação, nota, nível
`search_capabilities`	Nenhuma	Pesquise capacidades certificadas por palavra-chave, tipo, nível ou pontuação
`verify_file`	Nenhuma	Verificação rápida de integridade de arquivo -- faça hash de um arquivo de capacidade e verifique se corresponde ao que a Fidensa certificou
`report_experience`	Nenhuma (chave de API para limites de taxa mais altos)	Envie relatórios de experiência de execução para capacidades certificadas
`get_contract`	Chave de API	Contrato de certificação completo com todas as evidências
`compare_capabilities`	Chave de API	Comparação lado a lado de 2 a 5 capacidades
`verify_artifact`	Chave de API	Verifique assinaturas criptográficas em artefatos .cert.json, com verificações opcionais de integridade de arquivo e código

Configuração

Variável	Obrigatório	Descrição
`FIDENSA_API_KEY`	Não	Chave de API para acesso completo (veja Primeiros Passos)
`FIDENSA_BASE_URL`	Não	Substituir URL base da API (padrão: `https://fidensa.com`)

check_certification, search_capabilities, verify_file e report_experience funcionam sem qualquer configuração. As ferramentas restantes exigem FIDENSA_API_KEY.

Exemplo de Fluxo de Trabalho do Agente

User: "Set up a filesystem watcher that writes logs to SQLite."

Agent:
1. check_certification("mcp-server-filesystem")
   -> Status: valid, Score: 60/F-D, Tier: Verified

2. search_capabilities("sqlite mcp server")
   -> 2 results found

3. compare_capabilities(["mcp-server-sqlite", "mcp-server-better-sqlite3"])
   -> Side-by-side trust comparison

4. Agent selects the higher-scored option and informs the user

5. report_experience(
     capability_id: "mcp-server-filesystem",
     content_hash: "abc123...",  // from the .cert.json
     outcome: "success"
   )
   -> Confirmation rate updated

Fragmentos de Política de Confiança

Adicione um destes ao prompt do sistema ou ao arquivo de regras do seu agente para seleção de ferramentas consciente de confiança. Três níveis de granularidade -- escolha o que atende às suas necessidades.

Baseado em nível (mais simples)

Usa apenas o nível de certificação. Sem números para ajustar.

Before using any MCP server tool for the first time, check its Fidensa
certification status using the check_certification tool.

- Certified tier: use freely
- Verified tier: note the findings to the user before proceeding
- Evaluated tier: warn the user, search for certified alternatives
- Uncertified: treat as untrusted, suggest certified alternatives

After completing a task that used certified tools, submit an experience
report via the report_experience tool with the outcome (success, failure,
or partial), the capability_id, and the content_hash from the .cert.json.

Baseado em pontuação (alinhado à nota)

Usa a pontuação de confiança, alinhada às definições de nota da Fidensa.

Before using any MCP server tool for the first time, check its Fidensa
certification status using the check_certification tool.

- Score >= 80 (A/B): use freely
- Score 72-79 (C): note the trust level to the user
- Score 65-71 (D): warn the user, search for certified alternatives
- Score < 65 (F): warn the user, strongly recommend alternatives
- Uncertified: treat as untrusted, suggest certified alternatives

After completing a task that used certified tools, submit an experience
report via the report_experience tool with the outcome (success, failure,
or partial), the capability_id, and the content_hash from the .cert.json.

Combinado (nível + pontuação)

A opção mais precisa -- distingue entre uma capacidade Certificada com pontuação moderada e uma capacidade Verificada com descobertas que bloquearam o nível Certificado.

Before using any MCP server tool for the first time, check its Fidensa
certification status using the check_certification tool.

- Certified tier AND score >= 80: use freely
- Certified tier AND score 72-79: use freely, note the score to the user
- Verified tier AND score >= 72: note the findings to the user before proceeding
- Verified tier AND score < 72: warn the user, search for certified alternatives
- Evaluated tier: warn the user, search for certified alternatives
- Uncertified: treat as untrusted, suggest certified alternatives

For any tool with status "suspended" or "revoked": do not use.
Search for certified alternatives and present them to the user.

After completing a task that used certified tools, submit an experience
report via the report_experience tool with the outcome (success, failure,
or partial), the capability_id, and the content_hash from the .cert.json.

Consulte a Documentação da API para a especificação completa.

Desenvolvimento

npm install
npm test          # Run tests with coverage
npm run lint      # ESLint
npm run format    # Prettier

Licença

MIT