Fidensa MCP Server

@fidensa/mcp-server

F idensa の MCP サーバーです。Fidensa は、独立した AI 能力認証機関です。

Model Context Protocol を通じて、AI エージェントが Fidensa の認証データに構造化された方法でアクセスできるようにします。MCP ツールの呼び出しだけで、信頼スコアの確認、認証済みの代替手段の検索、機能の並列比較、署名済みアーティファクトの検証、ファイルの整合性確認、実行時の利用体験の報告を行えます。

Fidensa は、MCP サーバー、スキル、エージェントのルールファイル、フック、サブエージェント、プラグインを認証します。

はじめに

1. インストール

npm install -g @fidensa/mcp-server

2. 動作を確認する

一部のツール（check_certification、search_capabilities、verify_file、report_experience）は API キーなしで動作します。サーバーを起動し、本番 API に接続できることを確認します。

fidensa-mcp-server

次のように表示されます。

[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.

Ctrl+C を押して停止します。

3. API キーを取得する（任意、無料）

残りのツール（get_contract、compare_capabilities、verify_artifact）には無料の API キーが必要です。API キーを使うと、report_experience のレート制限も緩和されます。次の手順で登録します。

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

または、PowerShell で次を実行します。

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

レスポンスには API キー（fid_ で始まる文字列）が含まれます。安全に保管してください。キーが表示されるのは一度だけです。

4. エージェントに追加する

プラットフォームを選び、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"
      }
    }
  }
}

オープンティアのツールのみを使う場合は、FIDENSA_API_KEY の行を省略してください。

Claude Desktop のヒント： 設定ファイルは「Settings → Developer → Edit Config」から開けます。保存した後、Claude Desktop を完全に終了して再起動してください（システムトレイのアイコンを右クリックして「Quit」を選択してください。ウィンドウを閉じるだけでは終了しません）。

ツール

ツール	認証	説明
check_certification	なし	信頼性をすばやく確認します。ステータス、スコア、グレード、ティアを表示します
search_capabilities	なし	キーワード、種類、ティア、スコアで認証済み機能を検索します
verify_file	なし	ファイルの整合性をすばやく確認します。機能ファイルのハッシュを計算し、Fidensa の認証内容と一致するか検証します
report_experience	なし（レート制限の緩和には API キーが必要）	認証済み機能の実行時の利用体験を報告します
get_contract	API キー	すべての証拠を含む、認証契約の全情報を取得します
compare_capabilities	API キー	2～5 件の機能を並べて比較します
verify_artifact	API キー	.cert.json アーティファクトの暗号署名を検証します。必要に応じてファイルとコードの整合性も確認できます

設定

変数	必須	説明
FIDENSA_API_KEY	いいえ	すべての機能にアクセスするための API キー（はじめにを参照）
FIDENSA_BASE_URL	いいえ	API のベース URL を上書きします（デフォルト：https://fidensa.com）

check_certification、search_capabilities、verify_file、report_experience は、設定なしで動作します。残りのツールには FIDENSA_API_KEY が必要です。

エージェントのワークフロー例

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

信頼ポリシーの断片

信頼性を考慮したツール選択を行うには、次のいずれかをエージェントのシステムプロンプトまたはルールファイルに追加します。粒度の異なる3つのレベルから、用途に合うものを選んでください。

ティアベース（最もシンプル）

認証ティアのみを使用します。調整が必要な数値はありません。

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.

スコアベース（グレードに準拠）

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.

組み合わせ（ティア＋スコア）

最も精度の高い方法です。中程度のスコアを持つ Certified 機能と、指摘事項によって Certified ティアに達しなかった Verified 機能を区別します。

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.

仕様の全容については、API ドキュメントを参照してください。

開発

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

ライセンス

MIT

Links

• Fidensa -- AI certification authority
• API Documentation
• Certification Catalog
• Badge Integration Guide