あらゆるMCPクライアント

ホスト型のサーバー1つ

サーバーはhttps://mcp.foir.dev/mcpでホストされ、Streamable HTTPで通信します。各ツールは、コンソールやCLIが使うのと同じプラットフォームのRPCを呼び出すため、バリデーションと行レベルのスコープはプラットフォーム側で保たれます。公開が有効なモデルでは、レコードの書き込みは下書きとして保存され、公開と削除は別のツールです。エージェントは自分のモデルを持ち込むため、接続してもAIクレジットは消費されません。

認証の2つの方法

1つ目はサインインです。サーバーのURLをクライアントに追加すると、初回の使用時にブラウザでFóirの同意画面が開き、自分のレベルまでのアクセスを許可します。その後、エージェントは本人として動作します。

2つ目は、シークレットAPIキーで、CIや無人ジョブに向いています。foir mcpは、ホスト型サーバーへのローカルプロキシを実行し、FOIR_API_KEYにキーが設定されていれば、それを使います。エージェントの到達範囲は、そのキー自身のスコープになります。公開キーは拒否されます。

サインイン済みのエージェントが到達できる範囲

サインイン後、エージェントのトークンでできるのは、アクセス権のあるものの検出だけです。1つのワークスペースに入る必要があり、任意で、プロジェクト1つと組織も指定できます。その結果、そこでの実効権限を持つ作業用トークンが発行されます。作業用トークンの有効期間は30分で、再発行されます。ワークスペースとプロジェクトを呼び出しごとに選ぶことはできません。

ツールの一覧はリクエストごとに、資格情報が持つものに応じて絞り込まれるため、同じエージェントを同じプロジェクトに接続した2人に、異なるツールが提示されることがあります。

読み取り専用の接続

同意画面で読み取り専用にチェックを入れると、エージェントには読み取りツールだけが提示されます。同意は、エージェントがあとで何を読み取っても上限として働くため、コンテンツに紛れた指示で、読み取り専用の許可を書き込みに変えることはできません。CLIプロキシには、サインイン済みセッション向けの対応するフラグがあります。キーを絞り込むことはできません。