摘要
通过任何 AI 助手搜索 Untappd 的啤酒数据库。按名称、酿酒厂或风格查找啤酒;读取带评分的啤酒详情;查询场所和签到记录。4 个工具,需要免费的 Untappd API client_id + client_secret。
试试这样问
Untappd 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
仅限自托管。 Untappd 会拒绝来自数据中心 IP 地址的请求,而 AnythingMCP Cloud 运行在数据中心,因此该连接器无法在 AnythingMCP Cloud 上使用。它可以在你自己运行的 AnythingMCP 实例上工作,前提是该实例所在的电脑或服务器使用普通的家庭或办公网络。
Untappd + Microsoft Copilot
通过任何 AI 助手搜索 Untappd 的啤酒数据库。按名称、酿酒厂或风格查找啤酒;读取带评分的啤酒详情;查询场所和签到记录。4 个工具,需要免费的 Untappd API client_id + client_secret。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
UNTAPPD_CLIENT_ID, UNTAPPD_CLIENT_SECRET
步骤 1 — 获取凭证
This connector wraps Untappd's REST API (api.untappd.com/v4).
Setup: Untappd requires a free API client_id + client_secret. Apply for them at https://untappd.com/api/register. Approval is usually fast.
Provide:
UNTAPPD_CLIENT_ID— your app's client IDUNTAPPD_CLIENT_SECRET— your app's client secret
What's exposed: public, unauthenticated endpoints (no user OAuth needed for basic search + lookup). For per-user data (your check-ins, your wishlist), you'd need OAuth — not included in this connector.
Rate limits: Untappd publishes 100 req/hour per client. The connector does not auto-retry on 429; respect the limit.
…(continued in the in-app connector instructions)
步骤 2 — 安装 adapter
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并注册。第一个账户会成为管理员。 - 打开连接器商店(
http://localhost:3000/connectors/store),选择 Untappd,填写它要求的凭证(有些连接器不需要),然后安装。 - 在 MCP Servers 中创建一个服务器,并把 Untappd 连接器分配给它。在该服务器的页面上复制 MCP endpoint(
http://localhost:4000/mcp/<server-id>),并在 API keys 下生成一个密钥。
快速启动只监听 localhost。如果需要一个其他人或云端 AI 客户端也能访问的实例,请克隆仓库并运行 ./setup.sh,它会配置域名、HTTPS 和 OAuth(部署指南)。
第 3 步 —— 在 Microsoft Copilot 中添加 Untappd 连接器
Copilot Studio 从 Microsoft 的云端连接 MCP 服务器,因此无法访问快速启动的 localhost endpoint。要在 Microsoft Copilot 中使用 Untappd,你需要一个具有公网 HTTPS 地址的 AnythingMCP 实例(见上文的 ./setup.sh),并且它所在的网络要被 Untappd 接受。在 Copilot Studio 中打开你的智能体,进入 Tools → Add a tool → New tool → Model Context Protocol,粘贴该实例的 MCP endpoint,并选择 API key,请求头为 X-API-Key。然后把智能体发布到 Microsoft 365 and Microsoft Teams 渠道。
如果无法提供公网实例,请改用在你电脑上运行的客户端:Claude Code、Cursor 或 Gemini CLI 可以直接访问 localhost。
可用工具
| Tool | What it does |
|---|---|
untappd_search_beer | Search Untappd for beers by free-text query (name, brewery, style) |
untappd_get_beer | Full detail of one beer by ID — brewery, style, ABV, IBU, ratings, recent check-ins, label |
untappd_search_brewery | Search Untappd for breweries by free-text query |
untappd_get_brewery | Full detail of one brewery by ID — location, beer list, social stats |
FAQ
为什么 AnythingMCP Cloud 上没有 Untappd? Untappd 会拒绝来自数据中心 IP 地址的请求。AnythingMCP Cloud 运行在数据中心,因此每次调用都会失败。部署在家庭或办公网络上的 AnythingMCP 实例通常可以正常使用。
这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?