pipa-connectors

Pipa コネクター

Pipa の接続済みツールを設定、確認、説明、またはトラブルシューティングします。

メンタルモデル

• これは業務領域ではなく、操作です。
• pipa-manage は Pipa の設定を振り分けます。このスキルはコネクターの設定とステータスを担当します。
• 業務領域は仕事を担当し、composio-mcp は稼働中のアプリの検出、認可、操作を実行します。
• ~/.pipa/CONNECTORS.md には、選択した機能とツールのマッピングを記録します。稼働中の接続ステータスの正本は引き続き Composio です。
• ~~ プレフィックスはグローバルマップを通じて解決される機能のプレースホルダーであり、ツールキットのスラッグではありません。

機能カテゴリ

• ~~chat、~~email、~~calendar、~~project tracker
• ~~code hosting、~~knowledge base、~~cloud storage、~~CRM
• ~~support platform、~~content platform、~~payments、~~time tracking

業務領域マップ

Pipa の業務領域	一般的なコネクターカテゴリ
仕事を獲得する	~~CRM、~~email、~~chat、~~project tracker、~~content platform、~~knowledge base
仕事を定義する	~~email、~~chat、~~knowledge base、~~cloud storage、~~project tracker、~~code hosting、~~calendar
仕事を納品する	~~project tracker、~~chat、~~code hosting、~~calendar、~~knowledge base
支払いを受ける	~~payments、~~time tracking、~~email、~~CRM、~~calendar
クライアントとの関係を維持する	~~CRM、~~email、~~chat、~~calendar、~~project tracker、~~support platform
業務を改善する	~~knowledge base、~~cloud storage、~~code hosting、~~project tracker、~~calendar、~~chat、~~email

グローバルコネクタマップを確認する

1. ~/.pipa/CONNECTORS.md が存在する場合は読み込みます。
2. composio-mcp で検出を行い、サポートされているツールキットと有効な接続ステータスを確認します。稼働中の確認を行う前に、選択したツールのスキーマ全体を確認します。
3. 有効な接続を関連する機能カテゴリにマッピングします。同じカテゴリに複数のツールを割り当てられる場合、またはマッピングが不明確な場合に限り、質問します。
4. 検証済みの有効な接続またはユーザーが明示的に選択した内容に基づいて、提案するコネクタマップの差分を正確に提示します。無関係なマッピングは保持します。
5. ~/.pipa/CONNECTORS.md を作成または更新する直前に、その差分に対する明示的な承認を必ず得ます。コネクタマップの書き込み承認と認可リンクの完了は別々です。一方から他方を推測してはなりません。
6. 承認された差分のみを適用し、ファイルへの書き込みを検証して、成功または失敗を報告します。書き込みに失敗した場合、マップが更新されたと主張してはなりません。
7. 認証情報、認可リンク、シークレット、接続ステータスは決して保存しません。マッピングされたツールが有効だと主張する前に、Composio で確認します。

次の形式を使用し、関連するカテゴリのみを含めます。

---
updated_at: <ISO-8601 timestamp>
---

# Pipa Connectors

| Capability | Tool | Toolkit |
|---|---|---|
| `~~project tracker` | Linear | linear |

マップは永続的なツール選択の設定であり、現在アクセスできることの証明ではありません。検出と検証は読み取り専用のままにする必要があります。稼働中の確認には composio-mcp による検出と、選択したツールの完全なスキーマを使用し、リクエストされた各ソースを used、partial、stale、empty、declined、unavailable、または failed として報告します。not-requested は、リクエストの対象範囲外のソースに限って使用します。部分的なソース、古いソース、または拒否されたソースを、空または網羅的なものとして扱ってはなりません。安全であれば、他の利用可能な証拠を使って作業を続け、重要な確認結果には直接リンクまたは安定した ID を引用します。任意のコミュニケーション確認は、既知の不足に絞って行い、受信トレイやチャンネルを広範囲にスキャンしてはなりません。

コネクターを追加する

1. コネクターがサポートすべき Pipa のジョブを特定します。
2. ジョブをコネクターのカテゴリと対象アプリに対応付けます。
3. 必要最小限の権限を選択します：読み取り、書き込み、公開、通知、スケジュール、管理。
4. composio-mcp の検出機能を使ってツールキットと接続状況を確認し、実行前に選択したツールのスキーマ全体を調べます。
5. ユーザーが接続を明示的に依頼し、検出結果が未接続を示している場合は、MCP が提供する認証リンクをそのまま返して待ちます。リンクの完了は認証への同意を意味します。リンクの完了前後に、追加の認証確認を求めないでください。
6. 認証後、最小限かつ安全な読み取り専用チェックを実行します。
7. 書き込みの直前に、提案するコネクターマップの差分を正確に提示し、別途、明示的な承認を求めます。認証リンクの完了をマップへの書き込み承認と見なさないでください。
8. 承認された差分のみを適用し、書き込みの成功または失敗を確認して報告した後、何が接続されたか、Pipa で何ができるか、残っている課題を要約します。

出力仕様

• コネクターの目的。
• 対象アプリまたはツールキット。
• 必要な権限カテゴリ。
• 現在の接続状況：connected、needs-auth、declined、unavailable、failed、not-reviewed、または TBD。
• コネクターマップの更新内容、または TBD。
• セットアップ操作または認証手順。
• 書き込み、公開、通知に関する安全上の注意。
• ライブチェックを行った場合は、その出典情報。
• リクエストされたすべての情報源について、状態を used、partial、stale、empty、declined、unavailable、または failed のいずれかで示します。対象外の場合に限り not-requested を使用します。
• 提案するコネクターマップの正確な差分、承認状況、確認済みの書き込み結果または失敗。

安全ルール

• ツールから返されたステータスまたは検証済みの実行時の証拠がない限り、接続中と主張しないでください。
• チャットでユーザーに秘密情報をそのまま尋ねないでください。
• 書き込み、送信、公開、リマインダー、トリガー、金融関連の変更で接続をテストしないでください。
• コネクターが業務をサポートする場合も、業務上の目的が分かるように維持し、ここではセットアップのみを行ってください。
• ユーザーがすでに接続済みのアプリを今すぐ使いたい場合は、業務上の目的を維持し、実行には composio-mcp を使用してください。
• グローバルマップは、検証済みの検出結果またはユーザーの明示的な選択に基づいてのみ更新します。マッピングを推測しないでください。
• 認証情報、認証リンク、秘密情報、ライブステータスをコネクターマップに保存しないでください。
• 接続の明示的な依頼に対して、検出機能から MCP の認証リンクが直接返されることがあります。ユーザーがリンクを完了するまで待ちます。リンクの完了は認証への同意を意味するため、追加の認証確認を行わないでください。
• コネクターマップへの書き込みは、別個の外部状態変更です。提案する差分を正確に提示し、書き込みの直前に明示的な承認を必ず求めてください。認証リンクの完了をマップへの書き込み承認と見なしてはいけません。