InstaVision MCP 是 InstaVision 的 MCP 服务器，用于让 AI 智能体进行 Instagram 细分领域发现。它帮助用户按细分领域、城市、粉丝数范围或相似账号查找 Instagram 创作者和潜在客户。用户可以用自然语言向智能体提问（例如“查找尼日利亚的外汇指导账号，粉丝 2k–50k，上限 100 积分”），智能体会选择 playbook、估算积分、启动运行并返回结果。运行记录会显示在 InstaVision 仪表板中，并消耗账户积分：1 积分 = 扫描 1 个资料。
连接方式有两种：
- 远程连接：能够向 HTTP MCP 服务器发送请求头的客户端（Claude Code、Cursor、Codex）可直接连接到 https://instavision.co/api/mcp/mcp，无需安装任何东西。
- 本地桥接：npx instavision-mcp 是一个轻量本地桥接，适用于运行本地（stdio）服务器的客户端，例如 Claude Desktop。它将 MCP 流量（包括服务器指令）转发到同一个托管服务器。桥接本身不在磁盘上保存任何内容；密钥保存在客户端配置中。
设置指南和限制见 instavision.co/mcp。
获取 API 密钥：登录 InstaVision（会进入 Settings → API keys），创建一个密钥（只显示一次，请复制）。密钥以 iv_sk_ 开头。不要将真实密钥输入命令行，否则会留在 shell 历史记录中。
连接客户端：
- Claude Code：在终端（bash 或 zsh）中粘贴命令并按回车，然后等待输入密钥；粘贴密钥并按回车。密钥不会显示或保存到 shell 历史记录；Claude Code 会将其存储在 ~/.claude.json 中，并在每个项目中提供该服务器。
- Cursor：配置文件为 ~/.cursor/mcp.json。Cursor 和 Codex 从 INSTAVISION_API_KEY 环境变量读取密钥，因此必须在它们启动的环境中设置该变量。
- Claude Desktop（通过此包）：配置文件为 claude_desktop_config.json。在 Settings → Developer → Edit Config 中添加配置块，用你的密钥替换 iv_sk_...，然后重启 Claude Desktop。任何运行本地 MCP 服务器的客户端都可以使用相同的 command、args 和 env。
- Windows：如果 npx 启动失败，请使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "instavision-mcp"]。
连接后，让智能体“列出 InstaVision playbooks”以确认连接成功。
桥接也可以在没有 INSTAVISION_API_KEY 的情况下启动：它会无密钥连接并在 stderr 上打印提示。客户端随后可以列出工具和 playbooks 并估算积分；需要账户的调用（启动运行、读取结果、已见账号列表、PDF 导出）会失败，并提示前往 API 密钥页面。
智能体可以执行的操作：列出 playbooks、估算积分、启动发现（消耗积分）、检查运行状态、获取结果、导出 PDF、管理已查看过的账号。
环境变量（此包）：桥接仅将密钥作为 Authorization: Bearer 请求头发送到该端点，并在发送任何内容之前检查端点。可以在 API 密钥页面撤销密钥。
InstaVision 是独立产品，与 Instagram 或 Meta 无关联，也未获得其认可。
