AI エージェント（MCP）

ベータ

MCP エンドポイントは構築済みで、テストクライアントに対してテストされています。ベータとしてお取り扱いください。機能の提供状況をご覧ください。

Atlas は Model Context Protocol エンドポイントを公開しているため、ウェブサイトのリポジトリで作業する AI コーディングエージェントが、移行の反復的な部分を担当できます。サイトコントラクトのモデル化、画像のアップロード、エントリーとページの作成、翻訳の下書きなどです。

エージェントにできること・決してできないこと

エージェントにできること	エージェントに決してできないこと
コントラクトの読み取り、変更の検証と提案	コントラクトの承認または有効化
ページ、エントリー、グローバルの下書きの作成と編集	いかなる環境でも公開すること
翻訳の下書き	ロールバックまたは削除
メディアのアップロード	本番環境に一切触れること
チャットボットの下書きの作成と編集	シェルコマンド、SQL、ファイルアクセスの実行、URL の取得
	何かをデプロイすること

すべての下書きは、担当者が Studio でレビューし、公開します。

エージェントを接続する

1. Studio で Integrations → Coding agents → New connection を開きます。開発環境と、エージェントに必要な権限（グラント）を選びます。

   • contract:read、contract:propose
   • content:draft
   • media:upload
   • bots:draft
   • plans:read（Read website plans: 承認済みのヘルパーのブループリント、パレット、デザイントークン。このリリースで新規追加）

   接続を作成できるのは、サイト管理者と組織管理者だけです。Create connection をクリックします。

2. トークンをコピーします。amc_ で始まり、一度だけ表示されます。

3. エージェントにサーバーを追加します。エンドポイントは Streamable HTTP を使用します。

   {
     "mcpServers": {
       "atlas": {
         "type": "http",
         "url": "https://mcp.atlas.example/mcp",
         "headers": { "Authorization": "Bearer ${ATLAS_MCP_TOKEN}" }
       }
     }
   }

   トークンは環境変数に保管し、コミットするファイルには決して書かないでください。

4. エージェントに atlas.connection.get を呼び出すよう依頼します。サイトとその開発環境が報告されるはずです。

Studio の Guides には、移行の各ステップ向けのすぐに使える指示書があり、サイトの値が入力されています。

安全のための制御

• 接続は開発環境に対してのみ作成でき、90 日以内に期限が切れます。
• plans:read が登場する前に作成した接続は、この権限を得るために作成し直す必要があります。
• 各呼び出しは、稼働中の接続に対して確認されるため、接続を取り消すと次の呼び出しから有効になります。
• 呼び出しにはレート制限があり（デフォルトは 1 分あたり 120 回）、すべての書き込みに冪等性キーが必要です。
• エージェントの操作は監査ログに記録されます。

ツール

グラント	ツール
（常時）	atlas.connection.get
contract:read	atlas.contract.get, atlas.contract.list, atlas.contract.proposal.get
contract:propose	atlas.contract.validate, atlas.contract.propose, atlas.contract.proposal.withdraw
content:draft	atlas.pages.list, .get, .createFromType, .sections.update; atlas.entries.list, .get, .upsertDraft; atlas.globals.list, .get, .updateDraft; atlas.translations.get, .updateDraft
media:upload	atlas.media.list, atlas.media.asset.get, atlas.media.uploadSlot.create
bots:draft	atlas.bots.list, .get, .create, .updateDraft
plans:read	atlas.helper.projects.list, atlas.helper.blueprint.get, atlas.brand.palettes.get, atlas.brand.designTokens.get（読み取り専用）

フォント、ライブラリ、アニメーション、デザインスキャン用のエージェントツールはなく、何かを公開または承認できるツールもありません。