集成

如何连接 Tunio MCP

在 Codex/Cursor 和 Claude Desktop 中连接 Tunio MCP 的分步指南。

Tunio MCP 让您的 AI 助手直接访问您的 Tunio 广播流和操作，使其能够读取当前曲目、列出电台和运行 MCP 工具。

要求

  • 已安装 Node.js（包含 npx）。
  • 可访问互联网。
  • 来自 cp.tunio.ai/api-keys 的 API 密钥。

切勿在截图、代码仓库或聊天中暴露您的 API 密钥。如果密钥泄露，请立即吊销并创建新密钥。

在 Codex / Cursor 中连接

  1. 打开 MCP 服务器设置

    在您的 AI 客户端中进入 MCP 服务器添加/编辑板块。

  2. 设置命令和参数

    使用 npx 作为命令，并将参数逐项作为独立条目添加：

    BASH
    -y
mcp-remote
https://agent.tunio.ai/mcp
--header
Authorization: Bearer YOUR_API_KEY

  3. 保存并刷新工具

    保存 MCP 配置并重启客户端（或刷新工具），让 Tunio 工具出现。

在 Claude Desktop 中连接

设置过程与 Codex/Cursor 相同。

  1. 添加新的 MCP 服务器

    在 Claude Desktop 中打开 MCP 设置并创建新服务器。

  2. 填写命令和参数

    使用相同的值：

    BASH
    command: npx
args:
  - -y
  - mcp-remote
  - https://agent.tunio.ai/mcp
  - --header
  - Authorization: Bearer YOUR_API_KEY

  3. 重启 Claude Desktop

    保存后重启应用，并确认 Tunio 工具已列出。

验证连接

运行一个简单的工具调用，例如 list_stations 或 get_user_context。

如果工具未出现：

  • 检查您的环境中是否可用 npx。
  • 验证 API 密钥。
  • 确保参数作为独立条目添加，而不是单一字符串。
  • 重启 AI 客户端。

如果测试调用返回数据（例如，您的广播流列表），说明 Tunio MCP 已正确连接。