EN 登录 开始使用
指南 · MCP 安装与配置

指南

8pt MCP 安装与配置

作者 8pt · 更新于

8pt MCP 的地址是 https://8pt.dev/api/mcp（Streamable HTTP），每个请求带上 Authorization: Bearer <API Key> 即可。Claude Code 用一行 claude mcp add 命令接入；Cursor、Codex、Windsurf、Trae 把同一个地址和请求头写进各自的 MCP 配置。API Key 在「设置 › API Key」创建，需要 Builder 方案。

#准备：API Key

登录 8pt，在设置 › API Key点「创建 Key」。完整的 Key 只显示一次，请立刻存进密码管理器或环境变量。每个账户最多 5 个 Key，需要 Builder 方案（Builder 方案 ¥45/月、¥128/季或 ¥379/年；另有创始终身版 ¥899，一次付款，限 100 席）。

提示

不要把 Key 提交到代码仓库。下面的配置都可以改成从环境变量读取。

#Claude Code

在终端运行一次，之后所有项目都能用：

终端
claude mcp add --transport http 8pt https://8pt.dev/api/mcp \
  --header "Authorization: Bearer <你的 API Key>"

在 Claude Code 里输入 /mcp 可以看到 8pt 是否已连接。

#Cursor

写入 ~/.cursor/mcp.json（全局）或项目里的 .cursor/mcp.json：

~/.cursor/mcp.json
{
  "mcpServers": {
    "8pt": {
      "url": "https://8pt.dev/api/mcp",
      "headers": { "Authorization": "Bearer <你的 API Key>" }
    }
  }
}

#Codex

写入 ~/.codex/config.toml，并在终端设置 export EIGHTPT_API_KEY=<你的 API Key>：

~/.codex/config.toml
# ~/.codex/config.toml
[mcp_servers.8pt]
url = "https://8pt.dev/api/mcp"
bearer_token_env_var = "EIGHTPT_API_KEY"

#Windsurf、Trae 与其他客户端

任何支持远程 MCP（Streamable HTTP）的客户端都能接入：在它的 MCP 配置里添加一个名为 8pt 的服务器，地址填 https://8pt.dev/api/mcp，请求头加 Authorization: Bearer <你的 API Key>。配置文件的位置以各客户端的文档为准，格式通常和 Cursor 相同：

mcp.json
{
  "mcpServers": {
    "8pt": {
      "url": "https://8pt.dev/api/mcp",
      "headers": { "Authorization": "Bearer <你的 API Key>" }
    }
  }
}

#用 CLI 打印配置

装了 8pt CLI 的话，可以直接打印对应客户端的配置，复制粘贴即可：

终端
npm i -g @8pt-dev/cli
8pt login
8pt mcp claude   # 或 codex、cursor

#锁定 8pt 审美

在项目根目录运行一次，把 8pt 设计规范写进 AGENTS.md、CLAUDE.md、.cursor/rules/8pt.mdc 和 .github/copilot-instructions.md。之后模型做界面会先查 8pt，再按 8pt 的模板、组件和主题来做：

项目根目录
npx @8pt-dev/cli init

#验证是否接通

在对话里直接提需求，例如「用 8pt 找一个按月 / 按年切换的定价组件，放进定价页」。接通后模型会调用 search_components 搜索、get_component 取回源码，再改写进你的项目。

#可用的工具

工具作用
design_ui按 8pt 规范设计一个页面或界面（建议先调用）
search_components按中文或英文描述搜索组件
get_component取回组件的完整接入提示词和源码
list_templates / get_template列出或取回整页模板
list_skills / get_skill列出或取回 Skill 的全部文件
get_theme取回主题的 CSS 变量
search_icons按名称搜索图标 SVG

#常见问题

8pt MCP 返回 401 怎么办？

检查三件事：请求头是否是 Authorization: Bearer 加完整的 Key；这个 Key 是否已被撤销；账户是否有有效的 Builder 方案。

一个账户能建几个 API Key？

最多 5 个。可以给不同电脑或不同编辑器各建一个，不用时随时撤销。

8pt MCP 支持哪些编辑器？

Claude Code、Cursor、Codex、Windsurf、Trae 等支持远程 MCP（Streamable HTTP）的客户端都可以；不支持 MCP 的工具可以用复制提示词或 8pt CLI。

MCP 和 CLI 有什么区别？

MCP 让模型在对话里自己搜索和取用 8pt 的内容；CLI 在终端里由你执行命令，把组件、模板、主题和 Skill 装进项目。两者用同一个 API Key。

相关阅读