spix MCP

spix mcp

Spix的MCP服务器——为任何兼容MCP的AI客户端提供电话号码、收件箱和语音。

spix-mcp 是一个独立的 模型上下文协议 该服务器将Spix的通信基础设施（电话、电子邮件、联系人、分析）作为MCP工具和资源公开。

将其连接到Claude Desktop、Cursor或任何兼容MCP的客户端，您的AI就可以接电话了。

______________________________________________________________________

安装

# via pip
pip install spix-mcp

# via uvx (no install needed)
uvx spix-mcp

还必须安装Spix CLI并进行身份验证：

curl -fsSL https://spix.sh/install.sh | sh
spix auth login

______________________________________________________________________

快速设置：克劳德桌面

最快的方法——使用Spix CLI中的内置安装程序：

spix mcp install claude

这会将正确的配置写入 ~/Library/Application Support/Claude/claude_desktop_config.json 自动。重新启动Claude Desktop，Spix工具立即出现。

或在中手动配置 claude_desktop_config.json:

{
  "mcpServers": {
    "spix": {
      "command": "uvx",
      "args": ["spix-mcp"],
      "env": {
        "SPIX_API_KEY": "spix_live_sk_your_key_here"
      }
    }
  }
}

从获取API密钥 app.spix.sh/设置/快捷键.

______________________________________________________________________

快速设置：光标

spix mcp install cursor

或者使用与上述相同的JSON结构手动添加到Cursor MCP配置中。

______________________________________________________________________

你的AI能做什么

连接后，您的AI客户端可以访问 43工具 （安全配置文件）或 49工具 （完整配置文件）涵盖所有Spix功能：

打电话

电子邮件

短信

战术

联系人

电话号码

Auth&API密钥

计费和分析

网络钩子

______________________________________________________________________

资源（可读状态）

MCP服务器还公开实时可读资源：

resource://calls/{id}/transcript     — Call transcript
resource://calls/{id}/summary        — Call summary + extraction
resource://sms/{id}/thread           — SMS thread
resource://playbook/{id}             — Playbook details
resource://contact/{id}              — Contact details
resource://contact/{id}/history      — Contact history
resource://phone/{id}/route          — Phone number routing
resource://billing/credits           — Credit balance
resource://billing                   — Billing overview

______________________________________________________________________

工具轮廓

对于生产部署， safe 是推荐的。使用 full 仅适用于值得信赖的客户。

______________________________________________________________________

配置

所有配置都是通过环境变量进行的：

范围访问示例

限制您的代理可以访问的内容：

{
  "mcpServers": {
    "spix": {
      "command": "uvx",
      "args": ["spix-mcp"],
      "env": {
        "SPIX_API_KEY": "spix_live_sk_your_key_here",
        "SPIX_DEFAULT_PLAYBOOK": "plb_call_abc123",
        "SPIX_SESSION_NAME": "sales-bot",
        "SPIX_TOOL_PROFILE": "safe"
      }
    }
  }
}

______________________________________________________________________

示例：让克劳德打个电话

配置后，您可以直接询问Claude（或任何连接的客户端）：

“使用潜在客户限定符剧本致电+19175550123，告诉我他们说了什么。”

克劳德将使用 spix_call_create，监视呼叫，然后呼叫 spix_call_summary 返回结果——无需编写任何代码。

______________________________________________________________________

运作原理

Your Agent (Claude, Cursor, etc.)
    ↓ MCP tool call
Spix MCP Server (this package)
    ↓ HTTP API call
Spix Backend (api.spix.sh)
    ↓ Carrier APIs
Phone call / Email / SMS

MCP服务器是MCP协议和Spix REST API之间的一个瘦桥。所有业务逻辑都在服务器端运行。

语音通话

当你的经纪人来电时 spix_call_createSpix：

1. 通过Telnyx/Twilio拨打号码
2. 用途 Deepgram Nova-3 用于实时语音识别
3. 用途 克劳德 用于会话生成
4. 用途 卡特西亚Sonic-3 用于文本转语音
5. 记录通话并生成记录+摘要

然后，您的代理人可以通过以下方式阅读成绩单和摘要 spix_call_transcript 和 spix_call_summary.

______________________________________________________________________

与spix CLI的关系

spix-mcp 是独立的MCP服务器包。完整版 Spix命令行界面 包括内置的MCP服务器(spix mcp serve)以及所有其他Spix命令。

使用 spix-mcp 如果您只需要MCP服务器（例如，用于Claude Desktop集成而不安装完整的CLI）。如果您希望终端中的所有Spix命令都可用，请使用完整的CLI。

______________________________________________________________________

需求

• Python 3.10+
• Spix帐户（电子邮件免费沙盒；电话代理计划）
• API密钥来自 app.spix.sh

______________________________________________________________________

链接

• Spix——人工智能代理通信基础设施： spix.sh
• 仪表板： app.spix.sh
• 文档——MCP服务器参考： docs.spix.sh/mcp
• Spix CLI——来自终端的电话、短信、电子邮件： Spix总部/Spix cli
• PyPI： pypi.org/project/spix-mcp
• 食谱——即用型代理工作流程： spix.sh/食谱
• 博客——教程和指南： spix.sh/blog
• X/推特： @spixhq

______________________________________________________________________

许可证

麻省理工学院——见 许可证