接続

HTTP 接続と MCP 接続を保存し、OAuth 接続を認可して、実行が使えるものを一覧します。接続の設定には、管理者キーか、ログイン中のオーナーまたは管理者が必要です。メンバーはカタログを読み取れます。呼び出しが仲介される仕組みについては、接続をご覧ください。

接続を保存

auth オブジェクト

{
  "type": "http",
  "url": "https://api.example.com/v2",
  "auth": { "type": "header", "header": "X-API-Key", "token": "sk_live_…" },
  "allowed_methods": ["GET"],
  "instructions": "Look up a payment with GET /v1/payments/{id}. Amounts are in cents."
}

レスポンスは {"name": "...", "type": "..."} です。Ephemeral は、保存する前に URL と認証情報の形式を検証します。

シークレットを再送せずに接続を更新するには、シークレットのフィールドを省き、同じ auth.type で保存します。保存済みのトークン、パスワード、クライアントシークレット、OAuth トークンは保持されます。auth.type を変更すると、認証は完全に置き換わります。

接続を一覧

接続を取得

接続を削除

OAuth 接続を認可

ブラウザーで URL を開き、アクセスを承認します。プロバイダーがエンジンの /oauth/callback にリダイレクトし、Ephemeral がコードを交換してトークンを保存すると、ブラウザーはダッシュボードに戻ります。各 URL は 1 回しか使えません。プロバイダーには、リダイレクト URI として https://app.ephemer.al/oauth/callback を登録してください。セルフホストのインストールでは、独自のドメインを登録します。

認可の進行中に、接続のクライアント ID または OAuth エンドポイントが変更された場合、コールバックは 409 で拒否されます。その場合は、最初からやり直してください。CLI では、ephemeral oauth connect NAME で 1 ステップで実行できます。

接続カタログ

[
  { "name": "docs-mcp", "type": "mcp", "allowed_methods": [], "allowed_tools": ["search", "get_document"], "authenticated": true },
  { "name": "payments-api", "type": "http", "allowed_methods": ["GET"], "allowed_tools": null, "authenticated": true }
]