MCP への接続
クライアントを接続する前に可用性を確認します。
ホストされた接続
Cloud MCP は https://mcp.altifigence.com/cloud-mcp を Streamable HTTP と OAuth で使用します。クライアント設定の前に 利用可否とクライアントの適格性確認 を参照してください。
クライアントのリモート MCP 接続設定に、正確なエンドポイントを追加します。
Account のサインインを完了し、同意ページで組織と要求された Cloud 権限を確認します。OAuth 認証情報はクライアントが管理します。
接続を初期化してクライアントのツール一覧を更新します。現在許可された Cloud ツール だけが表示されます。
読み取り権限がある場合、まず自分の ID とプロジェクト一覧を読みます。返されたプロジェクト ID をプロジェクト・ファイル読み取りに使用します。ファイル読み取りには準備済みワークスペースが必要です。
プロジェクト、ファイル、設定、Git の変更には
https://mcp.altifigence.com/cloud.writeを要求し、新たな同意を完了します。組織が各ツールを明示的に許可しなければなりません。保存済みファイルの変更前に現在のプロジェクト・ファイルリビジョンを読み、不確かな変更応答の後は、再試行を判断する前に状態を確認します。ランタイムのライフサイクル、ターミナル操作、ジョブには
https://mcp.altifigence.com/cloud.execute権限を要求し、新たな同意を完了します。Cloud での保存済み RTL 解析は、まだお客様に提供されていません。詳細は「ツールのワークフロー」を参照してください。利用可否はサービスリリースと組織のランタイム・ツールポリシーに依存します。個人 AI 接続では アカウントセキュリティ にある必要な AI スコープだけを要求し、組織のツール承認を得て新たな同意を完了します。返された安全なセットアップ URL を使用し、ユーザーが Cloud に直接プロバイダーキーを入力できるようにします。AI 応答を要求する前に、選択プロバイダー、モデル、コンテキスト、発生し得る費用を確認します。
新しいツール名には、既存権限内の新ツールであっても新たな同意が必要です。古いトークンの更新はそれらを追加しません。Console で選択されたプロジェクトは認可の付与ではありません。認可対象組織の変更には新しい同意が必要です。読み取り要求は停止中プロジェクトを起動しません。接続設定にアカウントトークン、ブラウザ Cookie、AI プロバイダーキーを追加しないでください。
初期化や認可に失敗した場合は トラブルシューティング を使用します。サイトルートや別プロファイルへのプロトコル要求の送信へ切り替えないでください。
インストール済みソフトウェア
ローカル XLS ツールには、検証済みの Linux CLI を ALTI_MCP_MODE=local-xls とともに使用してください。セットアップについては、CLI を参照してください。このモードは顧客 Cloud ディスパッチを使用しません。 ローカルとホストされた接続の違いは MCP の概要 を参照してください。
最初の読み取りを確認
接続された Altifigence アカウントと組織を読むようクライアントに依頼します。
アクセス可能なプロジェクトを列挙し、返されたプロジェクト ID を選びます。
選択したプロジェクトの状態を読み取ります。ファイルの読み取りが利用できない場合は、選択したプロジェクト、アクセス権限、および Cloud での現在のストレージ/サービスステータスを確認してください。ランタイムの起動は個別の実行アクションです。通常の保存されたファイルへのアクセスには、個人用ランタイムの起動は必要ありません。
ファイルを列挙し、返されたパスを 1 つ選びます。必要なら継続オフセットをたどり、完全な内容を読み取ります。
プロジェクト、パス、保存済みリビジョンを含む要約を依頼します。大きな作業に接続を使う前に、Cloud と照合します。
要求例:「自分の Altifigence Cloud プロジェクトを一覧表示してください。選んだプロジェクトの README を読み、セットアップ手順を要約し、使った保存済みファイルを特定してください。」これは公開された読み取り範囲内で動作し、対象を明示します。