摘要
读取一个 Podio 应用:它的字段定义、经过筛选的一页条目,以及单个条目。使用 Podio 应用认证登录。只读。
引导式设置
2 分钟将 Podio 连接到 Cursor
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Podio,再把你的 MCP URL 添加到 Cursor。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Podio 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装?直接使用 cloud.anythingmcp.com。 登录后点击 Connectors → Podio,粘贴你的凭据,生成一个 MCP API 密钥即可。无需 Docker,无需
git clone,也无需本地服务器。
Podio + Cursor
读取一个 Podio 应用:它的字段定义、经过筛选的一页条目,以及单个条目。使用 Podio 应用认证登录。只读。
前提条件
请参阅连接器内置的完整设置说明(在应用内商店中选择该连接器即可看到)。此连接器所需的环境变量如下:
PODIO_APP_ID, PODIO_APP_TOKEN, PODIO_CLIENT_ID, PODIO_CLIENT_SECRET
第 1 步 — 获取凭据
设置大约需要 5 分钟。你需要一个 Podio API 密钥(client id 和 secret),以及 AI 要读取的那一个 Podio 应用的 App ID 和 App token。
- 打开 https://podio.com/settings/api 并生成一个 API 密钥。将 client id 复制到
PODIO_CLIENT_ID,将 client secret 复制到PODIO_CLIENT_SECRET。Podio 只会显示一次 secret。 - 打开该 Podio 应用,然后点击扳手菜单,再选择 Developer。将 App ID 复制到
PODIO_APP_ID,将 App token 复制到PODIO_APP_TOKEN。 - 安装连接器并运行
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 密钥每小时统计调用次数: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 用户身份登录。
第 2 步 — 安装适配器
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
第 3 步 — 在 Cursor 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启 Cursor。
- 打开 Cursor → Settings → MCP,确认
anythingmcp已列出并处于已连接状态。 - 开始对话 — 智能体现在可以调用
Podio的工具。
可用工具
| 工具 | 功能 |
|---|---|
podio_get_app | 获取此连接器当前登录的 Podio 应用,包括每个字段(field_id、external_id、类型、标签、是否必填以及设置,例如… |
podio_filter_items | 筛选并列出此 Podio 应用中的条目 |
podio_get_item | 根据数字 item_id(来自 podio_filter_items)获取一个 Podio 条目,包含每个字段的 external_id、类型、标签和值 |
常见问题
Cursor 免费套餐支持自定义 MCP 服务器吗? 支持 — Hobby、Pro 和 Business 套餐均可使用 MCP。
后续步骤
这份指南对你有帮助吗?