/ ディレクトリ / プレイグラウンド / prismatic-skills
● コミュニティ prismatic-io ⚡ 即起動

prismatic-skills

作者 prismatic-io · prismatic-io/prismatic-skills

Prismatic.ioが提供するファーストパーティスキルで、コードネイティブなインテグレーションやカスタムコネクタを構築できます。UIを操作することなくコネクタを素早く立ち上げられます。

Prismaticがインテグレーションプラットフォーム向けに公開しているスキルです。コードネイティブなPrismaticインテグレーションの構築方法をClaude Codeに教えます。コネクタのスキャフォールディング、アクションハンドラの記述、SDKを使ったローカルテスト、デプロイまでをカバーします。公式提供で、スコープが明確です。

なぜ使うのか

主な機能

ライブデモ

実際の動作

prismatic-skill.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "prismatic-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/prismatic-io/prismatic-skills",
        "~/.claude/skills/prismatic-skills"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "prismatic-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/prismatic-io/prismatic-skills",
        "~/.claude/skills/prismatic-skills"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "prismatic-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/prismatic-io/prismatic-skills",
        "~/.claude/skills/prismatic-skills"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "prismatic-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/prismatic-io/prismatic-skills",
        "~/.claude/skills/prismatic-skills"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "prismatic-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/prismatic-io/prismatic-skills",
        "~/.claude/skills/prismatic-skills"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "prismatic-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/prismatic-io/prismatic-skills",
          "~/.claude/skills/prismatic-skills"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add prismatic-skill -- git clone https://github.com/prismatic-io/prismatic-skills ~/.claude/skills/prismatic-skills

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: prismatic-skills

社内APIに対応するカスタムPrismaticコネクタを構築する

👤 Prismaticを利用しているチームのインテグレーションエンジニア ⏱ ~90 min advanced

使うタイミング: Prismaticフローから呼び出す必要がある社内APIがある場合に使用します。

前提条件
  • Prismaticアカウント + SDK — npm i -g @prismatic-io/prism; prism login
  • スキルのインストール — git clone https://github.com/prismatic-io/prismatic-skills ~/.claude/skills/prismatic-skills
フロー
  1. コネクタをスキャフォールディングする
    Use prismatic-skills. Scaffold a connector for our Orders API — base URL, bearer auth, actions for list, get, create.✓ コピーしました
    → TSエントリポイント、マニフェスト、テストファイルを含むコネクタディレクトリ
  2. アクションを実装する
    Fill in the listOrders action with pagination and error handling.✓ コピーしました
    → 型定義とPrismaticの入出力規約に準拠したTS実装
  3. ローカルでテストする
    Run the test harness with a mock response.✓ コピーしました
    → prism testsの出力がグリーン

結果: フローから利用できるアクションを備えた、デプロイ可能なコネクタが完成します。

注意点
  • 入力バリデーションの欠落 — Prismaticはプラットフォーム境界でバリデーションを行いますが、ランタイムの安全性のためにZodなどを併用してください
組み合わせ: filesystem

既存のPrismaticコネクタに新しいアクションを追加する

👤 デプロイ済みコネクタのメンテナー ⏱ ~30 min intermediate

使うタイミング: 既存のインテグレーションに新しいアクション(例:返金フロー)が必要になった場合に使用します。

フロー
  1. パターンを確認する
    Use prismatic-skills. Look at the existing actions/ and mimic the pattern for a new 'refundOrder' action.✓ コピーしました
    → 既存のスタイルと一貫性のあるアクションファイル
  2. パブリッシュする
    Bump the connector version and deploy.✓ コピーしました
    → prism integrations:publishが成功

結果: 既存フローを壊すことなくコネクタが更新されます。

注意点
  • バージョンを上げずに入力スキーマを変更する — コネクタをバージョン管理してください。既存フローは移行が完了するまで旧バージョンを固定します

組み合わせ

他のMCPと組み合わせて10倍の力を

prismatic-skill + filesystem

複数コネクタのモノレポを管理する

Add connectors/widgets-api/ following the same pattern as connectors/users-api/.✓ コピーしました
prismatic-skill + github

スキルのコンテキストを活用してコネクタのPRをレビューする

Review this PR against Prismatic connector conventions.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
scaffold_connector name, auth type, actions 新規コネクタ作成時 0
write_action action spec アクションごとの実装時 0
run_tests connector path パブリッシュ前 local
publish_connector connector path デプロイ時 Prismaticデプロイ

コストと制限

運用コスト

APIクォータ
スキル内でのAPI制限なし
呼び出しあたりのトークン
中程度
金額
Prismaticプランに準拠。スキル自体は無料
ヒント
デプロイの手戻りを減らすため、プッシュ前にSDKでローカルテストを行ってください。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: Prismaticの認証情報はprism CLIで管理されます(スキル内には保存されません)
データ送信先: Prismaticプラットフォーム、およびコネクタが通信する各API

トラブルシューティング

よくあるエラーと対処法

prism login fails — トークンのスコープまたは有効期限の問題

ブラウザフローで再ログインしてください

確認: prism me
Connector publishes but flows can't see new action — コネクタはパブリッシュされたがフローで新しいアクションが表示されない

利用者がフロー設定でコネクタバージョンをアップグレードする必要がある場合があります

Input schema rejected — 入力スキーマが拒否される

Prismaticは特定の入力形式を要求します。公式ドキュメントまたはスキルのアクションテンプレートを参照してください

代替案

prismatic-skills 他との比較

代替案代わりに使う場面トレードオフ
Prismatic low-code UIシンプルなインテグレーションで、カスタムコードが不要な場合柔軟性が低く、gitでバージョン管理されない
Raw Prismatic SDK without skillSDKに精通している場合ガイド付きスキャフォールディングがない

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る