Clavis Mcp Server

Clavis MCP サーバー

Claude Desktop と MCP サーバーのための安全な認証情報管理です。

特長

• 🔐 認証情報を暗号化して保存（Fernet を使用した AES-128-CBC + HMAC-SHA256）
• 🛡️ サーバー側で認証情報を注入 — 生のキーが会話に含まれることはありません
• 🔄 OAuth トークンを自動更新
• 📡 薄い転送レイヤー — レート制限、監査ログ、使用状況の追跡はすべて Clavis サーバーが処理します

インストール

npx @clavisagent/mcp-server

または、グローバルにインストールします。

npm install -g @clavisagent/mcp-server

Claude Desktop での使用方法

Claude Desktop の設定ファイル（claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "clavis": {
      "command": "npx",
      "args": ["-y", "@clavisagent/mcp-server"],
      "env": {
        "CLAVIS_API_KEY": "eyJ..."
      }
    }
  }
}

Claude Code での使用方法

claude mcp add clavis -- npx -y @clavisagent/mcp-server

設定

変数	必須	デフォルト	説明
CLAVIS_API_KEY	はい	—	POST /v1/auth/login で取得する Clavis JWT です。サインアップ時に表示される cla_… キーではありません。
CLAVIS_API_URL	いいえ	https://clavisagent.com	Clavis インスタンスのベース URL です。セルフホスト環境ではこれを設定してください。

利用可能なツール

ツール	説明
call_service	推奨。 サーバー側で認証情報を注入して API を呼び出します。認証情報はサーバー側で上流リクエストに注入されるため、生のキーが会話に含まれることはありません。
get_credentials	レガシー機能です。指定したサービスの生のアクセストークンまたは API キーを返します。call_service を優先してください。
list_services	認証情報が保存されているすべてのサービスを一覧表示します
check_credential_status	サービスの認証情報の状態と有効期限を確認します

セキュリティに関する注意

get_credentials よりも call_service を優先してください。call_service はシークレットを サーバー側に保持するため、プロンプトインジェクションが発生しても、流出対象となる認証情報が コンテキストに含まれません。get_credentials は生のキーを会話に含めるため、 呼び出し元がトークンを自ら保持する必要がある場合にのみ使用します。

ライセンス

MIT