Podio MCP 服务器：应用字段与条目

💡 无需安装?直接使用 cloud.anythingmcp.com。 登录后点击 Connectors → Podio,粘贴你的凭据,生成一个 MCP API key 即可。无需 Docker,无需 git clone,也无需本地服务器。

Podio

读取一个 Podio 应用:它的字段定义、经过筛选的一页条目,以及单个条目。使用 Podio 应用认证登录。只读。

设置

设置大约需要 5 分钟。你需要一个 Podio API key(client id 和 secret),以及 AI 要读取的那个 Podio 应用的 App ID 和 App token。

1. 打开 https://podio.com/settings/api 并生成一个 API key。将 client id 复制到 PODIO_CLIENT_ID,将 client secret 复制到 PODIO_CLIENT_SECRET。Podio 只会显示一次 secret。
2. 打开该 Podio 应用,点击扳手菜单,再选择 Developer。将 App ID 复制到 PODIO_APP_ID,将 App token 复制到 PODIO_APP_TOKEN。
3. 安装连接器并运行 podio_get_app:它会完成登录,并返回该应用的名称和所有字段。

仅限一个应用:这四个值会让连接器以该应用的身份登录(Podio 应用认证)。访问令牌有效期为 8 小时,过期后连接器会自动重新登录。工作区中的其他应用无法访问:对该应用之外的调用会返回 403。Podio 的 API 是公开的,因此在 AnythingMCP Cloud 和自托管实例上都可以使用。

读取内容:podio_get_app 会返回每个字段的 field_id、external_id、类型、标签、是否必填以及设置,例如分类选项的 id。podio_filter_items 列出一页条目及其字段值。podio_get_item 通过该列表中的数字 item_id(而不是 app_item_id)打开单个条目。读取条目不会将其标记为已查看,因此不会清除你的 Podio 通知。

筛选与分页:AI 可以按字段的 external_id 筛选,也可以按 title、created_on、created_by、last_edit_on、tags、item_id、app_item_id 或 external_id 筛选。分类值使用选项 id;数字、金额和日期使用起止范围,日期可以是相对值,例如 -7d 或 +1w。文本字段无法筛选,但可以通过 title 筛选条目标题。每页默认 20 个条目,最多 100 个。

限制:Podio 按每个 API key 每小时统计调用次数:podio_filter_items 为 250 次,其他读取为 1,000 次。超出限制时 Podio 会返回 HTTP 420(而不是 429),AI 会等待后再重试。

常见错误:登录时出现 400,表示 client id、client secret、App ID 和 App token 不匹配。401 表示 Podio 拒绝了访问令牌:请重新保存连接器以便重新登录,并再次检查这四个值。403 表示该调用超出了此令牌可读取的那一个应用。404 表示不存在该 id 对应的应用或条目。

该连接器不会创建或编辑条目,不会读取评论或文件,不会打开其他应用,也不会以 Podio 用户身份登录。

前提条件:PODIO_APP_ID、PODIO_APP_TOKEN、PODIO_CLIENT_ID、PODIO_CLIENT_SECRET

在本地安装连接器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

打开 http://localhost:3000/connectors/store,选择 Podio,并粘贴“前提条件”中列出的环境变量。

可用工具

后续步骤

• 连接到 Claude
• 连接到 ChatGPT