prism-mcp

Prism MCP Server は、AI アシスタントがコードネイティブなインテグレーションやカスタムコンポーネントの開発で Prismatic API を利用できるようにする、ローカルの Model Context Protocol（MCP）サーバーです。

メモ

Prism には MCP サポートが組み込まれました。Prism 11 以降では、prism --mcp を使用してサーバーを起動してください。スタンドアロンの prism-mcp パッケージも引き続き利用できますが、この組み込みサポートへの移行を推奨しており、非推奨となっています。

コーディングアシスタントを使って Prismatic の開発や操作を行う方法については、AI 開発ガイダンスの新しい拠点である Prismatic エージェントスキルをご覧ください。npx skills add prismatic-io/agent-skills を実行して始めましょう。

機能

この MCP サーバーは、カテゴリー別に整理された複数のツールを提供します。ユースケースに最も適したツールセットを登録できます。

汎用ツール（常に利用可能）

• prism_me：ログイン状態を確認し、現在のユーザープロフィール情報を表示します
• prism_components_list：利用可能なすべてのコンポーネントとバージョンオプションを一覧表示します

インテグレーションツール（ツールセット：「integration」）

ユーティリティ

• prism_integrations_list：すべてのインテグレーションを一覧表示します
• prism_integrations_init：新しい Code Native Integration を初期化します
• prism_integrations_convert：既存の Low-Code Integration を Code Native に変換します
• prism_integrations_flows_list：インテグレーションのフローを一覧表示します
• prism_integrations_flows_test：インテグレーションのフローをテストします
• prism_integrations_flows_listen：フローを「リスニングモード」に設定して、Webhook のペイロードやポーリングトリガーの応答を取得し、prism_integrations_flows_test 用のペイロードとして保存します
• prism_integrations_import：指定したディレクトリからインテグレーションをインポートします

コード生成

• prism_install_component_manifest：CNI の src ディレクトリにコンポーネントマニフェストを生成します（[email protected] 以降が必要です）
• prism_install_legacy_component_manifest：従来のコンポーネントマニフェストをインストールするために、CNI の devDependencies に追加する行を生成します
• prism_integrations_generate_flow：CNI フロー用のボイラープレートファイルを生成します
• prism_integrations_generate_config_page：CNI 設定ページ用のボイラープレートコードを生成します
• prism_integrations_generate_config_var：設定変数用のボイラープレートコードを生成します
• prism_integrations_add_connection_config_var：利用可能な場合は接続ラッパー関数のパスを返し、そうでない場合は接続設定変数用のボイラープレートコードを生成します
• prism_integrations_add_datasource_config_var：利用可能な場合はデータソースラッパー関数のパスを返し、そうでない場合はデータソース設定変数用のボイラープレートコードを生成します

コンポーネントツール（ツールセット：「component」）

• prism_components_init：新しいコンポーネントを初期化します（WSDL／OpenAPI からの生成に対応）
• prism_components_publish：指定したディレクトリからコンポーネントを公開します
• prism_components_generate_manifest：Prismatic コンポーネントのマニフェストを生成します

ツールセットの設定

ツールはツールセットに整理されています。作業ディレクトリの後にツールセット名を引数として渡して選択します（コマンドライン引数を参照）。

• integration - インテグレーション関連のツールをすべて有効にします
• component - コンポーネント関連のツールをすべて有効にします
• 汎用ツールは、ツールセットの設定に関係なく常に利用できます

ツールセットの引数を渡さない場合、既定ですべてのツールが登録されます。認識されないツールセット名を指定すると、起動エラーになります。

前提条件

Prismatic に認証してください。サーバーには固定バージョンの Prism CLI が同梱されているため、サーバーが使用するための CLI をインストールする必要はありませんが、ログインは必要です。ログインコマンドを実行するには CLI をインストールしてください（コマンドは、サーバーが自動的に読み込む共有設定ファイルに認証情報を書き込みます）。または、ヘッドレス環境／CI 環境では、代わりに PRISM_REFRESH_TOKEN を設定してください。

npm install --global @prismatic-io/prism
prism login

使用方法

設定

設定の場所と方法は、使用している AI ツールによって多少異なりますが、以下が比較的标准的です。より具体的な手順は以下に記載しています。

設定例:

{
  "mcpServers": {
    "prism": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@prismatic-io/prism-mcp", "."],
      "env": {
        "PRISMATIC_URL": "https://app.prismatic.io"
      }
    }
  }
}

MCP サーバーを現在開いているワークスペースとは異なるディレクトリで実行したい場合は、. パス引数を実際の作業ディレクトリに置き換えてください。

{
  "args": ["-y", "@prismatic-io/prism-mcp", "/path/to/code-native/integration"]
}

コマンドライン引数:

• 第 1 引数: 必須。 Prism CLI コマンドを実行する場所を決定する作業ディレクトリのパスです。ほとんどのコーディングエージェント（Cursor や Claude Code など）は . を現在のワークスペースディレクトリとして解釈します。お使いのコーディングエージェントがこれをサポートしていない場合は、代わりにコードネイティブ統合またはカスタムコンポーネントプロジェクトの絶対パスを指定できます。

• 残りの引数: 任意。 有効にするツールセット（integration、component）です。ツールセットを指定しない場合、すべてのツールがデフォルトで登録されます。ツールセットを選択的に指定すると、パフォーマンスが向上する場合があります。たとえば、統合関連のツールのみを有効にするには次のようにします:

  {
    "args": ["-y", "@prismatic-io/prism-mcp", ".", "integration"]
  }
  

任意の環境変数オプション:

• PRISMATIC_URL: デフォルトは https://app.prismatic.io です。Prismatic テナントが別のリージョンでホストされている場合、またはプライベートスタックデプロイを使用している場合は、この変数に Prismatic の URL を設定してください。
• MCP_PRISM_PATH: バンドルされているものではなく、実行する特定の Prism CLI への絶対パス（例: ローカルでビルドした CLI）。通常のファイルを指している必要があります。それ以外の場合は、バンドルされた CLI が使用されます。

Claude Desktop でのインストール

上記の JSON 設定を claude_desktop_config.json ファイルに追加してください。

Claude Code でのインストール

この MCP サーバーを Claude Code で使用するには、上記の設定を作業ディレクトリの .mcp.json 設定ファイルに追加してください。

または、次を実行してください。

claude mcp add-json prism '{"type":"stdio","command":"npx","args":["-y","@prismatic-io/prism-mcp","."],"env":{"PRISMATIC_URL":"https://app.prismatic.io"}}'

Cursor でのインストール

Cursor Settings > MCP Tools から利用可能な MCP サーバーを設定し、上記の設定を mcp.json ファイルに追加してください。

または、このリンクをクリックして自動的にインストールします: Add MCP Server to Cursor

VS Code / GitHub Copilot でのインストール

上記の設定をワークスペース内の .vscode/mcp.json、またはグローバルな mcp.json ファイル（コマンドパレットの「Add MCP Server...」オプションからアクセス可能）に追加してください。

または、このリンクをクリックして自動的にインストールします: Add MCP Server to VS Code

その他のツール

お使いのエージェントが上記に記載されていない場合は、セットアップ手順について公式ドキュメントを参照してください。

Prismatic とは？

Prismatic は、B2B SaaS チームがより迅速に、より少ない開発工数で製品統合を提供できるようにする、業界をリードする組み込み型 iPaaS です。統合ライフサイクル全体をカバーするツールを開発者と非開発者の両方に提供する唯一の組み込み型 iPaaS であり、Prismatic にはローコードとコードネイティブの両方の構築オプション、デプロイと管理のツール、そしてセルフサービス型の顧客向けツールが含まれています。

Prismatic の比類のない汎用性により、チームはシンプルなものから複雑なものまであらゆる統合を 1 つの強力なプラットフォームで提供できます。世界中の SaaS 企業が、スタートアップから Fortune 500 企業まで、自社製品と顧客が利用する他の製品をつなぐために Prismatic を信頼しています。

Prismatic では、次のことができます：

• 直感的なローコードデザイナーまたはコードネイティブのアプローチを使い、お好みの IDE で統合を構築する
• 一般的な統合タスク向けの事前構築済みコネクターを活用する、または TypeScript SDK を使ってカスタムコネクターを開発する
• 顧客のセルフサービス向けに、ネイティブの統合マーケットプレイスを自社製品に埋め込む
• 強力な構成ツールを使って、顧客固有の統合インスタンスを構成およびデプロイする
• 包括的なログ、モニタリング、アラートで顧客を効率的にサポートする
• B2B SaaS 向けに設計された安全でスケーラブルなインフラストラクチャで統合を実行する
• 自社の製品、業界、開発ワークフローに合わせてプラットフォームをカスタマイズする

Prismatic を利用するのは誰ですか？

Prismatic は、顧客に統合を提供する必要がある B2B ソフトウェア企業のために作られています。成長中の SaaS スタートアップであっても、確立された大企業であっても、Prismatic のプラットフォームはお客様の統合ニーズに合わせてスケールします。

当社のプラットフォームは、特に専門的な業種別市場にサービスを提供するチームにとって強力です。接続するシステムの種類や統合要件がどれほど独特であっても、お客様の顧客が必要とする統合を正確に構築するための柔軟性とツールを提供します。

Prismatic を使ってどのような統合を構築できますか？

Prismatic は、シンプルなデータ同期から高度で業界固有のソリューションまで、あらゆる複雑さの統合をサポートします。チームはこれを使って、最新の SaaS であれ標準プロトコルやカスタムプロトコルを用いたレガシーシステムであれ、あらゆる種類のシステム間の統合を構築しています。以下にいくつかのユースケース例を示します：

• 自社製品を顧客の ERP、CRM、その他の業務システムと接続する
• 顧客固有の変換要件に合わせて、複数のソースからのデータを処理する
• カスタマイズ可能なトリガー、アクション、スケジュールでワークフローを自動化する
• 複雑な認証フローとデータマッピングのシナリオを処理する

Prismatic プラットフォームの詳細については、ウェブサイトとドキュメントをご覧ください。

ライセンス

このリポジトリは MIT ライセンスです。