🚀 Pica MCP Server
Model Context Protocol (MCP) サーバーで、Pica と統合され、標準化されたインターフェースを通じてさまざまなサードパーティサービスとシームレスにやり取りできます。このサーバーは、プラットフォーム統合、アクション、実行機能、強力なコード生成機能への直接アクセスを提供します。

🚀 クイックスタート
このセクションでは、Pica MCP Serverの基本的な使い方を説明します。まずはインストールとセットアップを行い、その後で機能を試してみましょう。
✨ 主な機能
🔧 ツール
- list_pica_integrations - 利用可能なすべてのプラットフォームとアクティブな接続をリスト表示します。
- get_pica_platform_actions - 特定のプラットフォームの利用可能なアクションを取得します。
- get_pica_action_knowledge - 特定のアクションの詳細なドキュメント(パラメータや使い方を含む)を取得します。
- execute_pica_action - 完全なパラメータサポートでAPIアクションを実行します。
🔌 プラットフォーム統合
- Picaを通じて100以上のプラットフォームに接続できます。
- 各プラットフォームに複数の接続を管理できます。
- リアルタイムの接続ステータスにアクセスできます。
🎯 スマートインテント検出
- アクションを即座に実行できます(例:「最後のGmailのメールを読む」、「Slackの #general チャンネルにメッセージを送信する」)。
- 統合コードを生成できます(例:「Gmailを使ってメールを送信するフォームを作成する」、「メッセージング用のUIを作成する」)。
- インテリジェントなコンテキスト処理が可能です。
🔒 強化されたセキュリティ
- 生成されたコードにシークレットを公開することはありません。
- 環境変数
PICA_SECRET
、PICA_[PLATFORM]_CONNECTION_KEY
を使用します。
- 本番環境で使用するためのサニタイズされたリクエスト構成を持ちます。
⚡ 直接実行
- MCPインターフェースを通じてアクションを直接実行できます。
- すべてのHTTPメソッド(GET、POST、PUT、DELETEなど)をサポートします。
- フォームデータ、URLエンコーディング、JSONペイロードを処理できます。
- パス変数、クエリパラメータ、カスタムヘッダーを渡すことができます。
🔒 安全な認証
- すべてのリクエストはPicaの安全なプロキシを通じて認証されます。
- 個々のプラットフォームのAPIキーを管理する必要はありません。
- セキュリティのための環境変数構成があります。
📦 インストール
npm install @picahq/mcp
セットアップ
PICA_SECRET=your-pica-secret-key
Picaのシークレットキーは、Picaダッシュボード から取得できます。
💻 使用例
スタンドアロンサーバーとして
npx @picahq/mcp
Claude Desktopでの使用
Claude Desktop で使用するには、サーバー設定を追加します。
MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"pica": {
"command": "npx",
"args": ["@picahq/mcp"],
"env": {
"PICA_SECRET": "your-pica-secret-key"
}
}
}
}
Cursorでの使用
Cursorのメニューで「MCP Settings」を選択し、MCP JSONファイルを更新して以下を含めます。
{
"mcpServers": {
"pica": {
"command": "npx",
"args": ["@picahq/mcp"],
"env": {
"PICA_SECRET": "your-pica-secret-key"
}
}
}
}
Dockerを使用する場合
Dockerイメージをビルドします。
docker build -t pica-mcp-server .
Dockerコンテナを実行します。
docker run -e PICA_SECRET=your_pica_secret_key pica-mcp-server
Smitheryを介したインストール
Smithery を介してClaude Desktop用のPicaを自動的にインストールするには、以下を実行します。
npx -y @smithery/cli install @picahq/mcp --client claude
Vercelへのデプロイ
このMCPサーバーをVercelにデプロイしてリモートアクセスを可能にできます。
-
Vercelアダプターを含む依存関係をインストールします。
npm install @vercel/mcp-adapter zod
-
Vercelにデプロイします。
vercel
-
MCPクライアントをリモートサーバーを使用するように設定します。
- Cursorの場合:
https://your-project.vercel.app/api/mcp
- Claude/Clineの場合:
npx mcp-remote https://your-project.vercel.app/api/mcp
を使用します。
詳細なVercelデプロイ手順は DEPLOYMENT.md を参照してください。
📋 統合コード生成の例
メールフォームの構築:
"Picaを使ってGmailでメールを送信できるReactフォームコンポーネントを作成してください"
Linearダッシュボード:
"Picaを使ってLinearのユーザーと割り当てられたプロジェクトを表示し、フィルタリングオプションを持つダッシュボードを作成してください"
QuickBooksテーブル:
"Picaを使ってQuickBooksの請求書を取得して表示し、検索とソート機能を持つページング可能なテーブルコンポーネントを構築してください"
Slack統合:
"Picaを使って複数のSlackチャンネルにメッセージを投稿でき、メッセージのスケジューリングが可能なフォームを持つページを作成してください"
🚀 直接アクション実行の例
Gmailの例:
"Picaを使ってGmailから最後の5通のメールを取得してください"
Slackの例:
"Picaを使って #general チャンネルに「10分後に会議があります」というSlackメッセージを送信してください"
Shopifyの例:
"Picaを使って私のShopifyストアからすべての商品を取得してください"
📚 ドキュメント
ツール
list_pica_integrations
利用可能なすべてのPica統合とプラットフォームをリスト表示します。利用可能なプラットフォームと接続を発見するために、最初にこのツールを呼び出してください。
パラメータ: なし
戻り値:
- プラットフォームごとにグループ化された接続済みの統合
- 説明付きの利用可能なプラットフォーム
- 概要統計情報
- 管理リンク
get_pica_platform_actions
特定のプラットフォームの利用可能なすべてのアクションを取得します。
パラメータ:
platform
(文字列、必須): ケバブケース形式のプラットフォーム名(例: 'ship-station', 'shopify')
戻り値:
- IDとタイトル付きの利用可能なアクションのリスト
- プラットフォーム固有のアクション数
- 次のステップのガイダンス
get_pica_action_knowledge
特定のアクションの包括的なドキュメントを取得します。execute_pica_action
を呼び出す前に、要件を理解するために必ずこのメソッドを呼び出してください。
パラメータ:
action_id
(文字列、必須): get_pica_platform_actions
からのアクションID
platform
(文字列、必須): ケバブケース形式のプラットフォーム名
戻り値:
- 詳細なアクションドキュメント
- パラメータ要件と構造
- API固有のガイダンスと注意事項
- 使い方の例と実装メモ
execute_pica_action
サードパーティプラットフォームで操作を実行するためにPicaアクションを実行します。重要: ユーザーがアクションを実行したい場合にのみこのメソッドを呼び出し、アプリケーションを構築するときには呼び出さないでください。
パラメータ:
platform
(文字列、必須): プラットフォーム名
action
(オブジェクト、必須): _id
、path
、method
を持つアクションオブジェクト
connectionKey
(文字列、必須): プラットフォームの接続キー
data
(オブジェクト、オプション): リクエストボディデータ
pathVariables
(オブジェクト、オプション): パス内で置き換える変数
queryParams
(オブジェクト、オプション): クエリパラメータ
headers
(オブジェクト、オプション): 追加のヘッダー
isFormData
(ブール値、オプション): マルチパート/フォームデータとして送信する
isFormUrlEncoded
(ブール値、オプション): URLエンコードされたフォームデータとして送信する
戻り値:
requestConfig
: サニタイズされたリクエスト構成
responseData
: プラットフォームからの実際のAPIレスポンス
🔧 技術詳細
エラーハンドリング
サーバーは包括的なエラーハンドリングを実装しています。
- ✅ すべてのツールのパラメータ検証
- ✅ 実行前の接続検証
- ✅ パス変数の検証と置換
- ✅ API失敗の適切なハンドリング
- ✅ デバッグ用の詳細なエラーメッセージ
- ✅ MCP準拠のエラーレスポンス
セキュリティ
- 🔐 必要な環境変数は1つだけ:
PICA_SECRET
- 🛡️ すべてのリクエストはPicaの安全なプロキシを通じて認証されます。
- 🔒 直接的なプラットフォームAPIキーの管理は必要ありません。
- 🚫 レスポンスにシークレットを公開することはありません。
- ✅ リクエスト構成はサニタイズされています。
- 🔍 ログから機密データはフィルタリングされます。
- 🛡️ 入力検証とサニタイズが行われます。
📄 ライセンス
GPL - 3.0
サポート
サポートが必要な場合は、support@picaos.com にご連絡いただくか、https://picaos.com をご覧ください。