Pipefy MCP

管道化MCP服务器

用于与Pipefy集成的模型上下文协议（MCP）服务器，允许人工智能助手自然地与Pipefy平台交互。

功能

此 MCP 服务器提供以下工具：

• 组织管理

- 列出可访问的组织

• 管道管理

- 列出所有管道 - 获取特定管道的详细信息（包括相和字段）

• 卡管理

- 列出管道中的卡 - 搜索卡片COM过滤器 - 获取卡片的完整详细信息 - 创建新卡片 - 更新现有卡片 - 移动卡进入时尚 - Deletar卡

• 数据库管理（表格）

- 列出组织的数据库 - 从数据库获取详细信息（包括字段） - 从数据库列出记录 - 获取记录的完整详细信息 - 创建新记录 - 更新现有记录 - Deletar记录

先决条件

• Node.js 18或更高级
• API代币管道化(如何获得您的令牌)

安装

1. 克隆仓库 ：

git clone 
cd pipefy-mcp

1. 安装依赖关系 ：

npm install

1. 编译工程 ：

npm run build

配置

从 Pipefy 获取 API 令牌

1. 登录 管道
2. 点击右上角的头像
3. 选择“设置”
4. 转到“个人访问令牌”
5. 点击“生成新令牌”
6. 复制生成的令牌

配置程序无克劳德桌面

编辑 Claude Desktop 配置文件 ：

没有macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 无窗口： %APPDATA%\Claude\claude_desktop_config.json

添加以下设置 ：

{
  "mcpServers": {
    "pipefy": {
      "command": "node",
      "args": ["/caminho/absoluto/para/pipefy-mcp/build/index.js"],
      "env": {
        "PIPEFY_API_TOKEN": "seu-token-aqui"
      }
    }
  }
}

替换 ：

• /caminho/absoluto/para/pipefy-mcp 您克隆仓库的完整路径
• seu-token-aqui 通过您的 Pipefy API 令牌

使用

设置完成后， 重新启动 Claude Desktop 。您可以使用自然命令，如：

使用范例

组织列表 ：

Quais organizações do Pipefy eu tenho acesso?

Listar管道：

Liste todos os meus pipes do Pipefy

查看管道的详细信息：

Mostre os detalhes do pipe [ID_DO_PIPE]

列表卡：

Liste os cards do pipe [ID_DO_PIPE]

公交车卡：

Busque cards no pipe [ID_DO_PIPE] com o termo "urgente"

创建卡片 ：

Crie um card no pipe [ID_DO_PIPE] na fase [ID_DA_FASE] com o título "Nova Tarefa"

更新卡片 ：

Atualize o card [ID_DO_CARD] com o título "Tarefa Atualizada"

Mover um卡：

Mova o card [ID_DO_CARD] para a fase [ID_DA_FASE]

删除卡片 ：

Delete o card [ID_DO_CARD]

Listar数据库：

Liste os databases da organização [ID_DA_ORGANIZACAO]

查看数据库详情：

Mostre os detalhes do database [ID_DO_DATABASE]

列出数据库记录 ：

Liste os records do database [ID_DO_DATABASE]

创建记录 ：

Crie um record no database [ID_DO_DATABASE] com o título "Novo Cliente"

更新记录 ：

Atualize o record [ID_DO_RECORD] com o título "Cliente Atualizado"

删除记录 ：

Delete o record [ID_DO_RECORD]

可用工具

列表_组织

列出 API 令牌可访问的所有组织。

list_pipes

列出组织或用户的所有管道。

参数 ：

• organization_id （可选）： 组织 ID

get_pipe

获取有关特定管道的详细信息。

参数 ：

• pipe_id （必填）： 管道ID

列表卡

列出特定管道的卡 。

参数 ：

• pipe_id （必填）： 管道ID
• first （可选）： 返回卡的数量（默认： 50， 最大： 50）
• search （可选）：用于过滤卡的搜索保温瓶

搜索卡

使用特定标准在管道中查找卡片。

参数 ：

• pipe_id （必填）： 管道ID
• search （必填）： 搜索条件

get_card

获取有关特定卡的详细信息。

参数 ：

• card_id （必填）： 卡ID

创建卡

在管道中创建新卡 。

参数 ：

• pipe_id （必填）： 管道ID
• phase_id （必填）： 阶段 ID
• title （必填）： 卡片标题
• fields_attributes （可选）：字段值数组
• assignee_ids （可选）： 要分配的用户 ID 数组

更新卡

更新现有卡片。

参数 ：

• card_id （必填）： 卡ID
• title （可选）：新标题
• due_date （可选）： 到期日期 （格式： YYY-MM-DD）
• assignee_ids （可选）： 用户 ID 数组

move_card

将卡片移动到不同的阶段。

参数 ：

• card_id （必填）： 卡ID
• destination_phase_id （必填）： 目标阶段 ID

删除卡

Deleta um卡做管道。

参数 ：

• card_id （必填）： 卡ID

list_tables

列出组织中的所有数据库（表）。

参数 ：

• organization_id （必填）： 组织ID

get_table

获取有关特定数据库的详细信息，包括其字段。

参数 ：

• table_id （必填）： 数据库 ID

list_table_records

列出带有可选过滤的数据库记录 。

参数 ：

• table_id （必填）： 数据库 ID
• first （可选）： 要返回的记录数 （默认： 50， 最大： 50）
• search （可选）：用于过滤记录的搜索保温瓶

get_table_record

获取数据库中特定记录的详细信息。

参数 ：

• record_id （必填）： 记录 ID

create_table_record

在数据库中创建新记录。

参数 ：

• table_id （必填）： 数据库 ID
• title （必填）： 记录标题
• fields_attributes （可选）：字段值数组

- field_id （必填）： 字段 ID - field_value （必填）： 字段值

update_table_record

更新数据库中的现有记录。

参数 ：

• record_id （必填）： 记录 ID
• title （可选）：新标题
• fields_attributes （可选）： 要更新的字段值数组

- field_id （必填）： 字段 ID - field_value （必填）： 字段值

delete_table_record

从数据库中删除记录。

参数 ：

• record_id （必填）： 记录 ID

发展

可用脚本

• npm run build -JavaScript的安慰或打字
• npm run watch 以 watch 模式编译
• npm run dev 编译并运行服务器

项目结构

pipefy-mcp/
├── src/
│   └── index.ts       # Código principal do servidor MCP
├── build/             # Código compilado (gerado)
├── package.json       # Dependências e scripts
├── tsconfig.json      # Configuração do TypeScript
└── README.md          # Documentação

安全

• 永远不要共享您的 Pipefy API 令牌
• 令牌只能存储在 Claude Desktop 的本地配置中
• 令牌不应在仓库中提交

额外资源

• Pipefy API 文档
• 模型上下文协议 Model Context Protocol
• MCP规格

解决问题

服务器未启动

• 检查 API 令牌是否正确配置
• 检查文件路径 build/index.js 正确
• 执行 npm run build 确保代码被编译

认证错误

• 检查 API 令牌是否有效
• 必要时在 Pipefy 中生成新令牌

卡片没有出现

• 检查您是否拥有管道访问权限
• 检查管道 ID 是否正确

许可证

麻省理工学院

贡献

欢迎捐款！请开启 issue 或 pull request。