Skip to content

エージェントを接続する ​

Edge はツール群をすべて MCP で公開しています。エージェントに公開・本番切り替え・切り戻し・ドメイン管理・アナリティクス参照を任せられます。このページでは実際に接続し、動くことを確認します。

作業はアプリごとに一度だけです。コーディングツールに限らず、日常的に使うアシスタントでも同じように使えます。スマートフォンから Claude にサイトの切り戻しを頼む、といった使い方も現実的です。

エンドポイント ​

https://mcp.edge.deca-dev.com/mcp

MCP、API、認証情報を同じホストにそろえてください。詳しくは 環境とドメイン を参照してください。

パスなしの https://mcp.edge.deca-dev.com も同じサーバーに到達し、OAuth の リソース識別子として使われます。クライアントの設定には、Claude Code、ChatGPT などで一貫して動作する /mcp 付き URL を使ってください。

サーバーは streamable HTTP で通信します。ローカルプロセスではないため、インストールも起動コマンドも npx ラッパーも不要です。

サインイン ​

Edge は OAuth を使います。リモート MCP 認証に対応したアプリはブラウザを開いてサインインを求め、トークンはアプリ側が保持します。アクセストークンを貼り付ける必要はありません。自分で発行する必要もありません。

組織とワークスペースはサインインしたアカウントから決まります。アプリ側で設定する項目はありません。

DECA Agents ​

DECA Agents は DECA のアカウントの中にあります。アプリから Edge を接続します。URL の貼り付けも設定ファイルも不要です。

  1. DECA Agents を開きます。
  2. カスタマイズ を開きます。
  3. コネクタ を開きます。
  4. DECA Edge で 接続 します。
  5. ブラウザがサインインを求めたら完了します。

接続すると、名前が edge_ で始まるツールが一覧に並び、チャットから公開できます。

Claude ​

カスタムコネクタは Claude のアカウント設定に保存されるため、一度追加すればウェブアプリとデスクトップアプリの両方で使えます。ローカルの設定ファイルを編集する必要はありません。

  1. カスタマイズ → コネクタ を開きます。
  2. + をクリックし、カスタムコネクタを追加 を選びます。
  3. https://mcp.edge.deca-dev.com/mcp を貼り付けます。
  4. 接続し、開いたブラウザ画面でサインインを完了します。

Team および Enterprise プランでは、まずオーナーが 組織設定 → コネクタ で追加し、そのあとメンバーが カスタマイズ → コネクタ で有効にします。

Free、Pro、Max、Team、Enterprise で利用できますが、Free はカスタムコネクタ 1 つまでです。

ChatGPT ​

  1. 設定 → アプリとコネクタ を開き、開発者モード を有効にします。
  2. 作成 を選びます。
  3. 名前と説明を入力し、サーバー URL に https://mcp.edge.deca-dev.com/mcp を設定します。
  4. OAuth のサインインを完了します。

ChatGPT は /mcp パスが必要です

パスを省略すると接続に失敗します。Edge 側はどちらの形式でも動作しますが、ChatGPT だけはパスを要求します。

開発者モードは Plus、Pro、Business、Enterprise、Edu で利用できます。無料プランでは使えません。Business と Enterprise では、管理者が許可するまで項目自体が表示されないことがあります。

コーディングエージェント ​

bash
claude mcp add --transport http deca-edge https://mcp.edge.deca-dev.com/mcp --callback-port 8787

# 求められたら OAuth を完了します。明示的に開始する場合:
claude mcp login deca-edge
json
// プロジェクト単位は .cursor/mcp.json、全体は ~/.cursor/mcp.json
{
  "mcpServers": {
    "deca-edge": {
      "url": "https://mcp.edge.deca-dev.com"
    }
  }
}
json
// .vscode/mcp.json
{
  "servers": {
    "deca-edge": {
      "type": "http",
      "url": "https://mcp.edge.deca-dev.com"
    }
  }
}
toml
# ~/.codex/config.toml
[mcp_servers.deca-edge]
url = "https://mcp.edge.deca-dev.com"

[mcp_servers.deca-edge.oauth]
callback_port = 8788
callback_url = "http://127.0.0.1:8788/callback/nLq-cPQk3r9w"

この例の --callback-port 8787 は、Claude Code がこのマシンで待ち受けるポートです。空いているループバックポートならどれでも使えます。OAuth を完了したら /mcp を実行し、名前が edge_ で始まるツールが表示されることを 確認してください。claude mcp login deca-edge でも同じブラウザ認証を明示的に 開始できます。

Codex はサーバー追加後に codex mcp login deca-edge でサインインします。ブラウザが開きます。Codex は 127.0.0.1 のポート 8788 で待ち受け、callback URL のパスは https://mcp.edge.deca-dev.com(/mcp は付けない)に対して固定です。完了したら、名前が edge_ で始まるツールが表示されることを確認してください。

その他のクライアント ​

streamable HTTP のリモートサーバーに対応した MCP クライアントであれば動作します。上記の URL を設定してください。OAuth にも対応していれば、必要なのはそれだけです。トランスポートを選ぶ項目がある場合は、SSE ではなく streamable HTTP を選んでください。

動作を確認する ​

読み取りだけの操作を頼んでみます。

text
Edge の distribution を一覧して。

エージェントが edge_distribution_list を呼び出し、サイトの一覧を返すはずです。空のリストでも接続は成功しています。

401 が返る場合はサインインが完了していません。もう一度実行してください。403 は接続できているものの、その操作に必要な権限がアカウントにない状態です。403 の内容を確認したいときだけ 権限スコープ を参照してください。

同じ操作、ひとつのルール ​

エージェントを接続しても、できることが狭まるわけではありません。公開、ドメイン、アナリティクスの中核操作のほとんどには対応する HTTP ルートがあり、同じハンドラと同じ権限チェックを通ります。エージェントで公開し、curl で確認する、あるいはその逆も可能です。

面は完全には一致しません。function runtime の作成と実行、およびデータオブジェクトの履歴と切り戻しは MCP のみです。一方、組織のワークスペース一覧は HTTP のみです。例外は HTTP API リファレンス に印があります。

HTTP API は MCP とは 別の audience(https://api.edge.deca-dev.com)です。一方で有効なトークンが、もう一方でも有効とは限りません。

次に読む ​