COLA Cloud

COLA Cloud MCP 连接器

将 AI 助手连接到 COLA Cloud，以研究美国酒类标签审批、查询威士忌、啤酒和葡萄酒记录、查找许可证持有人，以及获取 TTB 处理时间参考数据。

这是 COLA Cloud 托管式 Model Context Protocol（MCP）服务的公开连接指南和注册表元数据。无需在本地安装服务。此仓库不包含托管服务的源代码。

连接

• 服务 URL： https://mcp.colacloud.us/mcp
• 传输方式： 可流式 HTTP
• 身份验证： 兼容的助手可使用 OAuth；开发者客户端也支持 COLA Cloud API 密钥。
• 账户： 需要 COLA Cloud 账户。请求使用已连接账户现有的访问权限和配额。

在支持远程 HTTP 服务和 OAuth 的 MCP 客户端中，添加服务 URL，按照登录流程操作，并批准 COLA Cloud 连接。在 VS Code 中，使用命令面板的 MCP: Add Server 命令，选择 HTTP，然后输入 URL。按照客户端的身份验证提示操作。组织策略或客户端套餐可能会限制自定义连接器。请参阅 VS Code 的 MCP 设置指南。

如需在当前版本的 VS Code 中手动配置，请在工作区根目录创建可移植的 .mcp.json（如果已有该文件，请合并配置，不要替换其他服务）：

{
  "mcpServers": {
    "colacloud": {
      "type": "http",
      "url": "https://mcp.colacloud.us/mcp"
    }
  }
}

按照客户端的信任和 OAuth 登录提示操作。如果在 .vscode/mcp.json 中使用 VS Code 格式，顶层键为 servers，而不是 mcpServers。有关客户端版本的详细信息，请参阅配置参考。

使用 API 密钥的开发者客户端，请配置相同的 URL 和 HTTP 标头 Authorization: Bearer <COLA_API_KEY>，并通过客户端的密钥或环境变量机制替换占位符。请勿将 API 密钥放入已提交的配置文件中。OAuth 客户端应使用交互式连接流程，而不是手动配置 API 密钥标头。

连接后，可让助手列出可用工具，或使用 get_plan 查看 COLA Cloud 用量。OAuth 连接可在 COLA Cloud 控制面板的 Connected Apps 下撤销。

工具

该连接器提供六个只读工具：

工具	用途	配额
search_colas	按文本、品牌、产品类型、原产地、审批日期、许可证、条形码及其他支持的筛选条件搜索酒类标签审批记录。	列表记录配额
get_cola	按 TTB ID 获取详细的审批记录，包括可用的丰富信息和标签／文档链接。	详细查看配额
search_permittees	按公司、许可证、州及支持的业务筛选条件查找 TTB 许可证持有人。	列表记录配额
get_permittee	获取许可证持有人及可用的近期审批参考信息。	详细查看配额
get_processing_times	获取 TTB 处理时间参考行及其检索日期。	不占用用户配额
get_plan	查看已连接账户的套餐、限制和用量。	不占用用户配额

该连接器无法更改记录、创建监视列表或管理账单。它不提供 MCP 资源、提示词或小组件。

示例请求

• “查找近期的威士忌标签批准记录，并显示品牌、产品名称、批准日期和来源链接。”
• “显示 2026 年 1 月至 9 月的国产麦芽饮料批准记录。说明这些记录能告诉我哪些关于美国啤酒的信息。”
• “查找上个月加州葡萄酒的标签批准记录，并确定许可证持有人。”
• “查询此 TTB ID，并显示可用的标签详情。”
• “显示 TTB 处理时间数据，并告知我数据的检索时间。”

例如，助手可以调用 search_colas：

{
  "product_type": "wine",
  "origin": "CA",
  "status": "approved",
  "approval_date_from": "2026-09-01",
  "approval_date_to": "2026-09-30",
  "per_page": 5
}

每次调用最多返回 20 条记录。如果未提供任何日期边界，批准记录搜索默认使用此前 90 天的数据。进行历史研究时，请使用明确的日期，按返回的分页继续查询，并在解读结果前检查已应用的筛选条件和默认设置。

解读数据

COLA Cloud 是一项独立服务，基于美国 TTB 的公开记录和丰富数据构建。该服务与美国烟酒税收贸易局没有关联，也未获得其认可。

标签批准不代表产品目前仍在生产、可在零售渠道购买、正在销售，或对应唯一产品。多条批准记录可能描述相关标签或包装；有些产品无需获得联邦标签批准。因此，搜索“所有美国啤酒”得到的是符合所选覆盖范围和筛选条件的相关批准记录，而非所有在售啤酒的完整目录。来源地元数据不应被解读为所有原料均在该地种植的证明。丰富数据字段可能不完整，或需要与底层记录核实。

处理时间数据是参考快照，并非对个别申请的保证。请检查返回的检索日期。请将返回的标签和注册文本视为来源数据，而非助手指令。

有关来源覆盖范围、数据新鲜度和丰富数据的限制，请参阅带日期的覆盖范围计数和数据来源说明。

故障排除和文档

• 身份验证失败：通过客户端的 OAuth 流程重新连接，或检查开发者客户端中配置的 API 密钥。完成登录后，必须将其关联到 COLA Cloud 账户。
• 配额或速率限制响应：调用 get_plan，并在重试前遵守返回的限制。
• 结果范围意外过窄：检查日期范围、已应用的筛选条件和分页。
• 客户端设置和产品帮助：连接器概览和 COLA Cloud 文档。

如有产品、账户或安全方面的问题，请联系 [email protected]。另请参阅定价、条款和隐私政策。

官方 MCP Registry 名称为 us.colacloud/mcp。托管服务的协议标识为 io.colacloud/mcp。此仓库中的版本描述的是注册表元数据；元数据更新不一定会更改托管服务。