スコープ

Engram を MCP コネクターとして追加すると、クライアントは OAuth アクセストークンを受け取ります。このトークンにはスコープが含まれ、 クライアントがあなたの保管庫に対して何をしてよいかが決まります。

現在トークンが許可すること

現時点で Engram の MCP エンドポイントが提供するスコープは、単一のまとまったスコープ mcp だけです。

mcp スコープのトークンは、クライアントに MCP のすべての機能を提供します。ノートの閲覧、意味検索、ノートの作成・編集、フォルダの編集、ファイルの添付などが可能です。個々の操作ごとに権限が細分化されるわけではなく、接続時に同意画面で選択した保管庫に限定されます。特定の保管庫を選択することも、すべての保管庫（後で作成する保管庫も含む）を選択することもできます。

きめ細かなスコープは計画中です

mcp をアクションごとのスコープ (notes:read、 notes:search、notes:write、notes:delete、folders:write、 metadata:read) に分割する予定が、ロードマップにあります。提供が始まれば、コネクターの フローで、現在のような「すべてか、なしか」ではなく、エージェントに必要な最小限の権限 (「読み取りと検索のみで、書き込みは不可」など) だけを付与できるようになります。

今すぐ細かい権限が必要な場合の回避策は、 保管庫への書き込みを任せられないエージェントは接続しないことです。 一度発行した許可を、プロトコルの中で制限する方法は、現時点ではありません。

アクセスの確認と取り消し

Engramアプリの設定 → 接続では、すべての有効なOAuth接続とAPIキーが一覧表示されます。接続を解除するには、取り消すをクリックしてください。

• APIキーが失効するとすぐに利用できなくなります。
• 取り消された OAuth 接続は、アクセスを再開できません。現在のアクセス トークンは15分で失効します。

スコープの文法 (SDK 開発者向け)

エンドポイントは、対応するスコープを /.well-known/oauth-authorization-server で公開しています。SDK 開発者は、スコープの文字列を ハードコードせず、このメタデータを読み取ってください。細かい分割は、まずここに現れるためです。