/ ディレクトリ / プレイグラウンド / 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

インストール

作者のリポジトリ · Claude Skills の公式ドキュメント

ユースケース

実用的な使い方: prismatic-skills

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

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

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

フロー
  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を見る