Tallyfy Workflow Automation

Tallyfy MCP 服务

这是 Tallyfy 的官方 Model Context Protocol 服务。Tallyfy 是一个工作流和流程自动化平台。它让任何支持 MCP 的 AI 助手都能运行你的运营工作：创建和跟踪任务、启动和推进流程、读取和编辑模板、填写表单字段、管理人员和群组，以及搜索整个组织的内容，所有操作都通过你自己的 Tallyfy 认证账户完成。

此仓库是自动发布的只读镜像。 Tallyfy 私下维护权威源代码，并在每次生产版本发布时，将经过清理的、仅包含服务端代码的快照发布到此处。请勿针对这个镜像提交拉取请求（无法在此合并）。如需报告错误或提出功能请求，请使用问题跟踪器或联系我们（参见支持）。托管、部署和监控代码不会包含在此镜像中。

连接（托管，推荐）

Tallyfy 运行着一个托管的远程服务。你无需托管任何内容。将 MCP 客户端指向：

https://mcp.tallyfy.com/

传输方式为可流式传输的 HTTP，身份验证使用你的 Tallyfy 账户通过 OAuth 进行，因此助手只能看到已登录用户有权查看的数据。

{
  "mcpServers": {
    "tallyfy": {
      "type": "streamable-http",
      "url": "https://mcp.tallyfy.com/"
    }
  }
}

功能

Tallyfy 领域内的 129 个工具，按类别分组：

几乎所有工具都会代表经过身份验证的用户调用 Tallyfy 公共 API（例外情况是读取公开文档索引和服务端的组织记忆存储）。已登录用户无法在 Tallyfy 应用中直接执行的写入操作，在这里也无法执行。

需要执行批量或脚本化任务？ 此服务针对交互式对话使用进行了优化，并限制单次请求可执行的操作量。对于高容量或无界面的自动化任务（从 CSV 启动流程、将每个模板导出到磁盘、循环处理多个组织、设置 CI/CD 审批关卡），请改用第一方 tallyfy CLI。它专为确定性、可脚本化的批处理操作而构建。使用 brew install tallyfy/tap/tallyfy 安装，或从发布页面获取二进制文件。

自行运行

你可以使用 Docker 从此镜像构建并运行服务。启动时无需配置：

cd server
docker build -t tallyfy-mcp-server .
docker run --rm -p 9000:9000 tallyfy-mcp-server
curl http://localhost:9000/health      # {"status":"healthy"}

服务在端口 9000 上监听，并在 /（以及 /mcp）提供可流式传输的 HTTP。如果你希望不使用 Docker 运行，则需要 Python 3.13（运行 pip install -r server/requirements.txt，然后在 server/ 目录内运行 uvicorn server:app）。

如需进行配置，请将 .env.example 复制为 .env，并通过 --env-file .env 传入。文件中的所有值都是可选的；默认值指向 Tallyfy 生产环境。

关于身份验证

每个 MCP 请求都需要 Tallyfy 签发的 OAuth 2.1 bearer 令牌（RS256）。服务会在每次调用时验证签名，因此未经身份验证的客户端会收到 401 挑战，无法访问任何 Tallyfy 数据。只有 /health 和 OAuth 发现文档是开放的。

验证密钥会自动为你解析。默认情况下，服务会读取 Tallyfy 发布的 JWKS（位于 https://account.tallyfy.com/.well-known/jwks.json），并自动获取轮换后的密钥。如果你想固定密钥并避免网络查询，可以将 TALLYFY_PUBLIC_KEY 设置为 PEM 公钥。如果这两个来源都无法解析密钥，服务仍会启动，但会拒绝所有令牌。

收录于

• 官方 MCP 注册表（com.tallyfy/mcp-server）
• GitHub MCP 注册表
• Smithery
• Glama
• PulseMCP

安全

工具仅限经过身份验证的用户使用，输入会经过验证，出站 API 范围也设有允许列表。本仓库不会披露任何静态凭据：所有密钥都通过环境变量在运行时提供。如果你发现安全问题，请发送邮件至 [email protected]，而不要公开提交问题。

支持

• 产品文档：https://tallyfy.com/products/pro/integrations/mcp-server/
• 帮助 / 联系方式：https://tallyfy.com/contact/

许可证

Apache License 2.0 © Tallyfy, Inc.