コンテンツへスキップ

ecentic開発者向け ドキュメント。

ecenticを呼び出すためにエージェントやエンジニアが必要とするものをすべて提供します。バージョン管理されたREST API、MCPサーバー、型付きエラー、公開済みのレート制限、さらに人を介さずクローラーが全体を検出できるディスカバリードキュメントを備えています。

公開エンドポイントはキー不要 · OpenAPI 3.1 · RFC 9457エラー

01

1回のリクエストでecenticを呼び出す

公開インターフェースは認証不要で、CORSも開放されています。まずはこちらから始め、マーチャントアカウントに対する操作が必要になった時点でキーを発行してください。

02

認証

公開読み取りはオープンです。マーチャントアカウントに触れる操作にはBearerキーが必要です。

ecenticでは、人がアカウントを作成した後に長期利用可能なAPIキーを発行します。アカウントを作成し、ダッシュボードまたは認証済みMCPツールcreate_api_keyからキーを発行し、保護されたすべての呼び出しでbearerトークンとして送信してください。キーは一度だけ表示されます。

有効なキーなしで保護された呼び出しを行うと、Protected Resource Metadataドキュメントを示すWWW-Authenticateヘッダー付きのHTTP 401が返されます。これにより、エージェントは推測ではなく失敗レスポンス自体から再度ディスカバリーを実行できます。

  • mcp — ecentic MCPエンドポイントに対してMCPツールを呼び出す
  • onboarding — Shopify、WooCommerce、商品フィードストアを接続する
POST https://ecentic.ai/api/mcp
03

エンドポイント

バージョン管理されたRESTインターフェースです。/api/v1配下のパスは、v1の提供期間中は安定しています。

04

エージェントプロトコル

ecenticは、エージェントがすでに利用しているコマースおよびツールプロトコルに対応しており、それぞれのマニフェストを公開しています。

06

MCPサーバー

Claude、ChatGPT、その他あらゆるMCPクライアントからecenticをネイティブに呼び出せます。

ecentic MCPサーバーはHTTP上でJSON-RPC 2.0を使用し、/mcpと/api/mcpの両方で利用できます。マニフェストは標準のwell-knownパスおよびSEP-1649サーバーカードとして公開されています。

読み取り専用ツール(list_plans)は認証不要で利用できます。キー作成、チェックアウト開始、ストア接続などアカウント状態を変更するツールにはbearerキーが必要です。

  • list_plans — プランとStripeでの利用可否
  • create_api_key — 長期利用可能なエージェントキーを発行
  • create_checkout — Stripe Checkoutセッションを開始
  • connect_shopify、connect_woocommerce、connect_feed — ストアのオンボーディング
https://ecentic.ai/.well-known/mcp.json
MCPサーバー
07

Webhook

ecenticはWebhookを受信しますが、現時点では外部への送信には対応していません。

受信エンドポイントでは署名検証を行い、検証に失敗したものはハンドラー実行前に拒否されます。ShopifyのコンプライアンスWebhookはHMACを検証し、Stripeは独自の署名ヘッダーを検証し、パートナーエンドポイントはbearerシークレットを検証します。

外向きWebhook — スキャン完了時や商品情報の再公開時にecenticがシステムへ通知する機能 — はまだ公開されていません。スキャン結果や商品情報の結果はダッシュボードで確認してください。公開REST APIではこれらのダッシュボード結果は提供していません。現在利用可能な操作についてはAPIリファレンスを参照してください。MCPリクエストはステートレスであり、サブスクリプションセッションは存在しません。

08

コマンドライン

HTTPクライアントを書かずにスクリプトからecenticを操作できます。

ecentic CLIは、このドキュメントで説明している公開インターフェース — ディスカバリー、プラン、スキル、ヘルスチェック、MCPツール呼び出し — をラップしています。これにより、エージェントや開発者は統合を構築する代わりにシェルから実行できます。

認証が必要なコマンドでは環境変数ECENTIC_API_KEYを参照し、stdoutへJSONを出力するため、すべてのコマンドをjqと組み合わせて利用できます。

コード例

このページ上のすべてのドキュメントは機械可読で、キーなしでアクセスできます。