mcpField
P
pipa-connectors

pipa-connectors

github.com/lunchpaillolaAgent 工作流3178 次安装6 天前更新
代码仓库

关于 pipa-connectors

用于配置、检查和排查 Pipa 已连接工具的技能，面向管理 Pipa 连接器的操作。它通过 Composio 验证工具发现和连接状态，并将经确认的能力映射写入全局连接器配置；写入前需单独批准。

主要功能

  1. 01检查连接器配置与映射
  2. 02通过 Composio 发现工具和连接状态
  3. 03按业务能力匹配工具
  4. 04提出精确配置差异供审批
  5. 05验证配置写入结果

适用场景

  1. 01为 Pipa 工作配置应用连接器
  2. 02排查已连接工具的状态
  3. 03更新全局连接器能力映射

MCP 相关

该技能使用 composio-mcp 发现工具、检查连接状态并执行获准的只读检查。它也可能直接返回 MCP 提供的授权链接。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/lunchpaillola/pipa-skills --skill pipa-connectors

安装后在 Claude Code 中输入/pipa-connectors确认已加载。

附带文件evals/evals.jsonevals/trigger-eval-set.json

详细介绍

Pipa 连接器

设置、检查、说明或排查 Pipa 已连接的工具。

心智模型

  • 这是一项操作，而不是业务领域。
  • pipa-manage 负责路由 Pipa 配置；此技能负责连接器的设置和状态。
  • 业务领域负责具体工作；composio-mcp 执行实时应用发现、授权和操作。
  • ~/.pipa/CONNECTORS.md 记录所选的能力到工具的映射。Composio 仍是实时连接状态的事实来源。
  • ~~ 前缀表示通过全局映射解析的能力占位符；它不是工具包 slug。

能力类别

  • ~~聊天、~~电子邮件、~~日历、~~项目跟踪器
  • ~~代码托管、~~知识库、~~云存储、~~CRM
  • ~~支持平台、~~内容平台、~~支付、~~时间跟踪

业务领域映射

Pipa 业务领域常见连接器类别
获取工作~~CRM、~~电子邮件、~~聊天、~~项目跟踪器、~~内容平台、~~知识库
定义工作~~电子邮件、~~聊天、~~知识库、~~云存储、~~项目跟踪器、~~代码托管、~~日历
交付工作~~项目跟踪器、~~聊天、~~代码托管、~~日历、~~知识库
收款~~支付、~~时间跟踪、~~电子邮件、~~CRM、~~日历
维护客户关系~~CRM、~~电子邮件、~~聊天、~~日历、~~项目跟踪器、~~支持平台
改进运营~~知识库、~~云存储、~~代码托管、~~项目跟踪器、~~日历、~~聊天、~~电子邮件

检查全局连接器映射

  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 授权链接。等待用户完成授权；完成链接即表示同意授权，因此不要再添加第二次授权确认。
  • 写入连接器映射仍属于独立的外部状态更改。显示拟议的确切差异，并在写入前立即要求明确批准；绝不要将完成授权链接视为批准写入映射。

评论

支持 Markdown