Claude Desktop
在 Claude Desktop 中打开 Settings → Developer → Edit Config,将配置保存到下方路径。
mac: ~/Library/Application Support/Claude/claude_desktop_config.json
windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"pipiads": {
"command": "npx",
"args": ["-y", "pipiads-mcp-server"],
"env": {"PIPIADS_API_KEY": "YOUR_PIPIADS_API_KEY"}
}
}
}
完全退出并重新打开 Claude Desktop,开启新对话,检查 PipiAds 工具是否可用。
已有其他 MCP 服务?只需将 pipiads 条目合并到现有的 mcpServers 中,保留其他配置。
ChatGPT
在 ChatGPT 桌面端打开 Settings → MCP servers → Add server,选择 STDIO。命令填 npx,参数填 -y 和 pipiads-mcp-server,添加环境变量 PIPIADS_API_KEY。也可将下方 TOML 添加到配置文件。
all: ~/.codex/config.toml
[mcp_servers.pipiads]
command = "npx"
args = ["-y", "pipiads-mcp-server"]
[mcp_servers.pipiads.env]
PIPIADS_API_KEY = "YOUR_PIPIADS_API_KEY"
保存后在 MCP servers 中点击 Restart。开启本地 Work 任务,输入 /mcp 检查 pipiads 连接,然后尝试下方的研究示例。
将下方配置添加到 ~/.codex/config.toml,保留已有设置。如果已存在 [mcp_servers.pipiads],请更新该配置,不要重复添加。ChatGPT 桌面端与 Codex 在同一主机上共用此文件。
Codex
使用 Codex 应用时,将下方 TOML 添加到 ~/.codex/config.toml 并替换 API Key 占位符。CLI 与 IDE 扩展共用此配置;如果使用 CLI,也可选择执行下方命令。
all: ~/.codex/config.toml
[mcp_servers.pipiads]
command = "npx"
args = ["-y", "pipiads-mcp-server"]
[mcp_servers.pipiads.env]
PIPIADS_API_KEY = "YOUR_PIPIADS_API_KEY"
重新启动 Codex 应用,在 MCP servers 设置中检查 PipiAds。CLI 用户可开启新会话并通过 /mcp 检查连接,codex mcp list 可查看已保存的配置。
将下方配置添加到 ~/.codex/config.toml,保留已有设置。如果已存在 [mcp_servers.pipiads],请更新该配置,不要重复添加。ChatGPT 桌面端与 Codex 在同一主机上共用此文件。
Claude Code
在项目终端中执行以下命令,执行前请替换 API Key 占位符。该命令会将服务添加到 Claude Code。
claude mcp add pipiads -e PIPIADS_API_KEY=YOUR_PIPIADS_API_KEY -- npx -y pipiads-mcp-server
运行 claude mcp list 检查服务,再在该项目中启动 Claude Code。使用 /mcp 查看连接状态。
Cursor
在项目根目录创建或打开 .cursor/mcp.json,添加下方配置并保存。
all: .cursor/mcp.json
{
"mcpServers": {
"pipiads": {
"command": "npx",
"args": ["-y", "pipiads-mcp-server"],
"env": {"PIPIADS_API_KEY": "YOUR_PIPIADS_API_KEY"}
}
}
}
打开 Cursor Settings → Tools & MCP(部分版本名称为 MCP),启用 pipiads,必要时重启 Cursor,然后使用 Agent 对话。
已有其他 MCP 服务?只需将 pipiads 条目合并到现有的 mcpServers 中,保留其他配置。
Windsurf
打开 MCP 配置文件并添加 PipiAds。以下路径相对于你的用户主目录。
all: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"pipiads": {
"command": "npx",
"args": ["-y", "pipiads-mcp-server"],
"env": {"PIPIADS_API_KEY": "YOUR_PIPIADS_API_KEY"}
}
}
}
在 Windsurf 中刷新 MCP 服务或重启应用,确认 Cascade 可以使用 pipiads。
已有其他 MCP 服务?只需将 pipiads 条目合并到现有的 mcpServers 中,保留其他配置。
OpenClaw
在 ~/.openclaw/openclaw.json 的 mcp.servers 中添加 pipiads,保留已有配置。此示例适用于支持原生 MCP 的 OpenClaw 版本。
all: ~/.openclaw/openclaw.json
{
"mcp": {
"servers": {
"pipiads": {
"command": "npx",
"args": [
"-y",
"pipiads-mcp-server"
],
"env": {
"PIPIADS_API_KEY": "YOUR_PIPIADS_API_KEY"
}
}
}
}
}
运行 openclaw mcp list 确认已保存 pipiads;这不代表已连接成功。按照实际使用该配置的 Gateway 或 Agent 进程的重载或重启流程使配置生效。如需单独验证工具发现,先停止本地 Gateway,再运行 openclaw mcp probe pipiads,随后重新启动 Gateway,并在新的 Agent 对话中确认可用的 PipiAds 工具。
将 pipiads 条目合并到现有的 mcp.servers 中,保留其他服务和设置;不要添加顶层 mcpServers。
其他客户端
使用支持本地 stdio MCP 的客户端。命令设为 npx,参数设为 -y 和 pipiads-mcp-server,环境变量 PIPIADS_API_KEY 设为你的密钥。不同客户端的 JSON 格式可能不同。
npx -y pipiads-mcp-server
在客户端重启或重新连接 MCP 服务。本软件包使用本地 stdio,不提供可直接填写的远程 HTTP 或 SSE 服务地址。
Grok Build
将下方配置添加到 ~/.grok/config.toml,并在本地填写 API Key。此方式用于 Grok Build。
all: ~/.grok/config.toml
[mcp_servers.pipiads]
command = "npx"
args = ["-y", "pipiads-mcp-server"]
[mcp_servers.pipiads.env]
PIPIADS_API_KEY = "YOUR_PIPIADS_API_KEY"
在 Grok Build 中输入 /mcps,刷新 PipiAds 服务后开启对话。
将配置合并到 ~/.grok/config.toml,保留已有设置。如果已存在 [mcp_servers.pipiads],请更新该配置,不要重复添加。