composio-mcp

适用场景

• 用户要求 Pipa 与 Gmail、Slack、GitHub、Notion、Linear、Google Calendar 等外部应用交互。
• 用户希望 Pipa 在已连接的服务中发送、创建、更新、获取、总结或监控记录。
• 用户要求执行连接应用相关操作，且当前 Agent 运行环境中提供了 Composio MCP 工具。
• 用户明确提到 Composio、Composio MCP、已连接的账户、外部应用工具或 Pipa 连接工作流。

核心规则

使用当前运行环境中提供的 Composio MCP 工具。不要改用任何非 MCP 的 Composio 工作流，不要在本地安装 Composio，也不要初始化项目。

如果没有可用的 Composio MCP 工具，请停止操作，并请用户为此 Agent 环境连接或启用 Composio MCP。

例外：如果 Pipa 正在进行只读评估，且有其他可用证据，则将 MCP 或账户访问不可用记录为信息来源缺口，并继续操作。除非用户要求连接，否则不要发起授权。

工作流

1. 如果请求含糊不清，请确认目标应用、操作和用户可见的结果。
2. 选择操作前，先检查可用的 Composio MCP 工具。
3. 优先选择能够完成请求的最小且具体的 MCP 工具。
4. 检查所需的已连接账户或授权是否可用。
5. 如果缺少授权，请用户完成 MCP 提供的连接流程，并等待确认。
6. 使用 MCP 工具并提供明确的参数来执行操作。
7. 简要说明操作来源：应用、操作、使用的工具，以及工具返回的相关记录 ID、URL、标题或时间戳。

MCP 工具使用模式

Composio MCP 可自我描述。请使用其元数据工具，而不要依赖本地参考文件。

1. 首先使用 MCP 工具发现操作，根据用户的使用场景进行搜索。
2. 查看返回的工具架构、连接状态、推荐计划和注意事项。
3. 如果某个工具集没有活动连接，请使用 MCP 连接管理操作，并将返回的授权链接提供给用户。
4. 如果工具结果指向架构参考资料，请在执行前获取完整架构。
5. 仅执行返回的工具标识符，并使用符合架构的参数。
6. 对于独立操作，在可用时使用 MCP 批量执行操作。

此技能所需的能力：

• 根据自然语言任务搜索相关的外部应用工具。
• 检测目标应用账户是否已连接。
• 在账户未连接时生成授权链接。
• 在授权生效后执行所选工具。
• 返回工具结果中的具体来源信息。

安全规则

• 不要猜测工具名称、工具集名称、账户 ID、问题 ID、电子邮件地址、频道名称或项目 ID。
• 除非 MCP 工具返回成功结果，否则不要声称操作已完成。
• 执行破坏性、不可逆、公开或会通知用户的操作前，请先征求确认。
• 对于写入操作，如果操作可能通知他人、更改项目状态或发布内容，请在执行前重述确切的目标和内容。
• 不要在提示词、文件、日志或回复中泄露机密信息。
• 如果当前状态很重要，应优先进行只读检查，再执行更改。

Pipa 使用说明

从 Pipa 调用时，请将 Composio MCP 视为已连接应用的执行层。Pipa 应负责管理项目管理意图，而 Composio MCP 应负责执行外部应用操作。

Pipa 的良好任务移交模式：

1. 确认项目管理意图：状态更新、创建工单、发送利益相关者消息、日历协调、查找文档或自动化支持。
2. 选择相关的外部应用 MCP 工具。
3. 仅通过 Composio MCP 执行已连接应用相关的操作。
4. 将结果返回给 Pipa，并提供足够的来源信息以便跟进。

响应模式

成功执行 MCP 操作后，请回复：

• 发生了哪些更改，或检索到了哪些内容。
• 使用的外部应用和 MCP 工具。
• 工具返回的具体记录引用。
• 仍需用户执行的任何操作。

如果受阻，请回复：

• 缺少的应用、帐户、权限或 MCP 工具。
• 所需的确切用户决定或连接步骤。
• 不使用 Composio MCP 之外的任何替代方案。