Agent 専用 MCP

既存の Public API Key で自分の Agent を Hast AIP に接続します。

このページは Agent クライアント専用です。Public API と MCP は同じ AIP 業務機能、キー、Profile、権限を使用します。AIP → API キーで既存キーを使用するか作成してください。MCP 専用キーは不要です。CRM と顧客対話ナレッジには business-resources:read/write が必要です。既存キーに新しい権限は自動付与されません。

接続設定

API キーページの API ドキュメントから対象環境の Backplane URL を取得し、BACKPLANE_URL を置き換えます。Streamable HTTP と Authorization: Bearer hast_pk_... を使用します。カスタムヘッダー対応のクライアントが必要です。下記をクライアントの設定形式に合わせて調整し、実際のキーをプロンプトやリポジトリに保存しないでください。Hast 側の認証は MCP OAuth ではなく API Key です。

{
  "mcpServers": {
    "hast": {
      "url": "BACKPLANE_URL/api/public/v1/mcp",
      "headers": { "Authorization": "Bearer <YOUR_EXISTING_PUBLIC_API_KEY>" }
    }
  }
}

Agent に渡すプロンプト

私の要望に応じて Agent、チャネル、ナレッジベース、CRM、Connector を作成・管理できるように、Hast AIP の MCP への接続を手伝ってください。

MCP URL：BACKPLANE_URL/api/public/v1/mcp
接続方式：Streamable HTTP
認証方式：既存の Public API Key を Authorization: Bearer ヘッダーで送信してください。HAST_API_KEY 環境変数または安全な認証情報ストアから読み取り、キーを表示しないでください。

接続後、hast://guides/overview でプラットフォームの機能を把握し、私の要望に応じて必要なガイドを参照し、ツールを使ってください。

追加情報、クライアントの設定、外部サービスの認可が必要な場合は、私が行う手順を教えてください。

機能を見つける

接続後に以下のリソースを読むと、前提条件、リクエスト例、作成順序、権限、検証手順を確認できます。リソース非対応クライアントは get_guides_topic と path.topic を使用できます。REST は GET /api/public/v1/guides/{topic} で同じ内容を取得できます。

hast://guides/overview
hast://guides/enterprise-agent
hast://guides/channels
hast://guides/whatsapp
hast://guides/knowledge-crm
hast://guides/connectors

企業向け Agent の構築と検証

実際のモデル、ポリシー、既存 Agent、Skill、ナレッジ、接続済みアカウントを確認します。
必要な Skill、書き込み専用 Secret、索引済みナレッジ、任意の CRM と顧客対話ナレッジを作成します。
POST /webhooks で AIP Agent を保存し、所有するリソースと必要な権限だけを選択します。
外部サービスの同意とインストールを完了し、チャネルを割り当て、返信ポリシーを確認します。
/webhooks/{hook_id}/invoke を実行し、イベントを終端まで読み、実際の回答、CRM、Connector、元のチャネルへの返信を検証します。
必要なスケジュールだけを設定し、タイムゾーン、次回実行、履歴を検証します。未完了の同意や配信は明記します。

API との同等性と制限

ツールは同じ公開ルートと権限検証を使用します。入力は path、query、body を分離し、結果は status と body、HTTP エラーは MCP isError で返します。ファイルは upload.filename、upload.data_base64、任意の form を使用し、復号後 10 MiB までです。MCP はイベントを有限ページで取得し、REST は SSE も提供します。MCP 応答は 16 MiB までで、大きなアーカイブは Public API を使用します。202 は受付であり完了ではありません。外部同意、実配信、課金条件は引き続き必要です。同じキーの失効で API と MCP のアクセスを停止できます。

MCP transport specification · Tools · Resources · Official Go SDK