{"pageKey":"Developers","slug":"developers","locale":"ja","localeResolved":"ja","fallbackApplied":false,"version":"developers@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/ja/developers","payload":{"slug":"developers","purpose":"llm-developers","title":"開発者 API、埋め込み、MCP ツールおよびエンタープライズ統合 | MerchandAise","description":"カスタム商品用の MerchandAise 開発者 API を探索します: OpenAPI ドキュメント、コミュニティ埋め込み、サプライヤー ワークフロー、エンタープライズ ID、および AI エージェント用の MCP ツール。","sections":[{"heading":"開発者プラットフォーム","paragraphs":["MerchandAise API、OpenAPI コントラクト、コミュニティ埋め込み、サプライヤー ワークフロー、エンタープライズ ID、および MCP ツールを使用して、カスタム商品を Web サイト、ポータル、および AI エージェントに接続します。"]},{"heading":"MerchandAise を使用してビルドする人","items":[{"title":"コミュニティオペレーター","description":"バージョン管理された公開契約を使用して、クラブ、リーグ、企業のサイト内で埋め込みストアフロント、コンフィギュレーターのハンドオフ、コミュニティ フローを開始します。"},{"title":"エンタープライズチームとプラットフォームパートナー","description":"承認やサプライヤーのロジックを再構築することなく、調達ポータル、ID システム、内部業務を商品ワークフローに接続します。"},{"title":"AI エージェントと自動化ビルダー","description":"アシスタントに、MCP 互換エンドポイントを介した検出、引用、および承認された操作のための構造化されたツールへのアクセスを提供します。"}]},{"heading":"統合サーフェスとコントラクト","items":[{"title":"API ドキュメント","description":"計画、テスト、およびバージョン管理されたリリース管理のために、人間が読めるドキュメントと機械が読める OpenAPI 契約を確認します。 Human guide: API ドキュメントを読む (/ja/developers/api-integrations). Machine-readable contract: OpenAPI JSON (/api/docs/openapi.json). Access: public. Public reference for assistant and tooling APIs. Production access and order-affecting operations still require the applicable authorization. Canonical section: /ja/developers#api-docs."},{"title":"コミュニティに API を埋め込む","description":"ロケールセーフなストアフロントの埋め込み、コミュニティ ワークフロー、およびバージョン管理されたパブリック コントラクトによる認証されたハンドオフを実装します。 Human guide: Explore community workflows (/ja/developers/api-integrations#community-integrations). Machine-readable contract: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. ストアフロントの埋め込み、コミュニティの検出、ロケールを意識したハンドオフのためのパブリック バージョンの契約。 Canonical section: /ja/developers#community-integrations."},{"title":"サプライヤー API","description":"フルフィルメント ワークフロー用に構築されたバージョン管理されたエンドポイントを通じて、オンボーディング、カタログ、サプライヤー側の操作を接続します。 Human guide: Explore partner workflow (/ja/developers/api-integrations#supplier-integrations). Machine-readable contract: Supplier OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. 企画とクライアント創出のための公共契約。運用上のサプライヤーへのアクセスは引き続き許可されます。 Canonical section: /ja/developers#supplier-integrations."},{"title":"エンタープライズ ID API","description":"SSO、SCIM プロビジョニング、および承認されたエンタープライズ アクセスのための保護された契約を通じてエンタープライズ ロールアウトとガバナンスのための監査対応 ID フローを統合します。 Human guide: Explore enterprise platform (/ja/developers/api-integrations#enterprise-integrations). Machine-readable contract: Enterprise identity OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. 承認されたエンタープライズ ワークスペースの保護された契約。このエンドポイントを使用する前にアクセスをリクエストしてください。 Canonical section: /ja/developers#enterprise-integrations."},{"title":"MCP ツール","description":"検出可能な MCP 互換ツール定義とアシスタント承認付きの実行エンドポイントを通じて、承認された MerchandAise 機能を AI エージェントに公開します。 Human guide: MCP 実装ガイドを読む (/ja/developers/ai-agents-mcp). Machine-readable contract: Public MCP server-card JSON (/.well-known/mcp/server-card). Access: public. Public discovery document for machine clients. The external tools list at /api/v1/mcp/tools exposes current tool metadata; each tool call still follows its declared security, workspace, and confirmation boundaries. Canonical section: /ja/developers#mcp-tools."}]},{"heading":"統合クイックスタート","items":[{"title":"Step 1: ワークフローに合った契約を選択してください","description":"ユーザーと認証モデルに一致するサーフェス (コミュニティの埋め込み、エンタープライズ ID、サプライヤーの運用、またはアシスタント用の MCP ツール) から始めます。"},{"title":"Step 2: 認証、バージョン管理、環境の境界を検証する","description":"本番トラフィックをルーティングする前に、ステージングで必要なヘッダー、スコープ、コールバックの期待、および契約バージョンを確認してください。"},{"title":"Step 3: 導入前にエンドツーエンドのワークフローをテストする","description":"リクエスト、Webhook、プロビジョニング、可観測性、ロールバック パスを検証して、最初のライブ使用時から統合が信頼できるようにします。"}]},{"heading":"What production-ready means","paragraphs":["運用統合にはパブリック エンドポイント以上のものが必要です。これらのゲートを使用して、ワークフローが顧客、サプライヤー、エンタープライズ、または AI エージェントのトラフィックに対応できるかどうかを判断します。"],"items":[{"title":"Sandbox and access review","description":"起動前に、どの契約が公開されているか、どのエンタープライズ サーフェスに承認が必要か、どの資格情報またはワークスペース ロールが必要であるかを確認します。"},{"title":"Versioned implementation evidence","description":"実稼働トラフィックが有効になる前に、生成されたクライアント、コールバック URL、認証スコープ、契約バージョン、ロールバック所有権を文書化しておいてください。"},{"title":"Operational observability","description":"注文、サプライヤー、エンタープライズ ユーザーに影響を与える可能性のあるすべてのワークフローのログ、再試行、サポートの所有権、障害状態、ヘルス チェックを計画します。"}]},{"heading":"統合レビューが必要ですか?","paragraphs":["アーキテクチャ、ロールアウトのタイムライン、宛先チャネルを共有します。適切なコントラクト サーフェス、認証パターン、起動シーケンスを推奨します。"],"items":[{"title":"統合チームに相談する","description":"/ja/contact/integrations"},{"title":"エンタープライズ プラットフォームを探索する","description":"/ja/enterprise"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}