后霍克 MCP 软件
联合国 https://posthog.com/docs/model-context-protocol 页面存档备份,存于互联网档案馆
使用 MCP 服务器
快速安装
您可以通过运行以下命令,将 MCP 服务器自动安装到 Cursor, Claude, Claude 代码, VS 代码和 Zed 中:
npx @posthog/wizard@latest mcp add
手动安装
-
使用 MCP 服务器预设获取个人 API 密钥 这里。 。 。 .
-
将 MCP 配置添加到您的桌面客户端( 如 Cursor, Windsurf, Claude Desktop)并添加您的个人 API 密钥
{
"mcpServers": {
"posthog": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://mcp.posthog.com/mcp", // You can replace this with https://mcp.posthog.com/sse if your client does not support Streamable HTTP
"--header",
"Authorization:${POSTHOG_AUTH_HEADER}"
],
"env": {
"POSTHOG_AUTH_HEADER": "Bearer {INSERT_YOUR_PERSONAL_API_KEY_HERE}"
}
}
}
}
嵌入器安装
如果您选择使用多克而不是直接运行 npx :
- 构建多克图像 :
pnpm docker:build
# or
docker build -t posthog-mcp .
- 用 Docker 配置您的 MCP 客户端 :
{
"mcpServers": {
"posthog": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--env",
"POSTHOG_AUTH_HEADER=${POSTHOG_AUTH_HEADER}",
"--env",
"POSTHOG_REMOTE_MCP_URL=${POSTHOG_REMOTE_MCP_URL:-https://mcp.posthog.com/mcp}",
"posthog-mcp"
],
"env": {
"POSTHOG_AUTH_HEADER": "Bearer {INSERT_YOUR_PERSONAL_API_KEY_HERE}",
"POSTHOG_REMOTE_MCP_URL": "https://mcp.posthog.com/mcp"
}
}
}
}
- 使用 MCP 检查器测试 Docker :
pnpm docker:inspector
# or
npx @modelcontextprotocol/inspector docker run -i --rm --env POSTHOG_AUTH_HEADER=${POSTHOG_AUTH_HEADER} posthog-mcp
环境变量:
POSTHOG_AUTH_HEADER: 您的 PostHog API 令牌( 需要)POSTHOG_REMOTE_MCP_URL: MCP 服务器 URL(可选,默认为https://mcp.posthog.com/mcp(中文(简体) )
此方法允许您使用 PostHog MCP 服务器, 而无需本地安装 Node.js 或 npm .
示例提示
- 我用什么标志?
- 为主页重新设计添加新功能旗
- 我最常见的错误是什么?
- 这周给我看看我的LLM成本
特性过滤
您可以通过在 MCP URL 中添加查询参数来限制哪些工具可用 :
https://mcp.posthog.com/mcp?features=flags,workspace
可用特性 :
workspace- 组织和项目管理error-tracking- 说吧 监测和调试出错dashboards- 说吧 板板的创建和管理insights- 说吧 分析见解和SQL查询experiments- 说吧 A/B测试实验flags- 说吧 特性旗管理llm-analytics- 说吧 LLM的使用和成本跟踪docs- 霍格后文件搜索
要查看每个功能可用的工具,见我们 文档 或换句话说 schema/tool-definitions.json, (中文(简体) ),
数据处理
MCP服务器主机位于一个Cloudflare工人上,该工人可以位于欧盟/美国之外,因此MCP服务器不存储您云区以外的任何敏感数据.
使用自主办实例
如果您正在使用 PostHog 的自托管实例, 您可以通过添加 POSTHOG_BASE_URL 环境变量 当在本地运行 MCP 服务器时或者在您的基础设施上运行时, 例如 . POSTHOG_BASE_URL=https://posthog.example.com
发展
要在本地运行 MCP 服务器, 请运行以下命令 :
pnpm run dev
替换 https://mcp.posthog.com/mcp 与 http://localhost:8787/mcp 在 MCP 配置中.
项目结构
该寄存器的编排是为了支持多种语言的实施:
typescript/- MCP服务器和工具的TypeScript执行schema/- 从 TypeScript 生成的共享计划文件
发展指挥部
pnpm run dev- 启动开发服务器pnpm run schema:build:json- 为其他语言实施生成JSON计划pnpm run lint && pnpm run format- 格式和线条编码
添加新工具
见 工具文档 用于向 MCP 服务器添加新工具的指南.
环境变量
- 创建
.dev.vars在树根中 - 添加 API 密钥以启用
docs-search工具(参见Inkeep API key - mcp(中文(简体) )
INKEEP_API_KEY="..."
配置示范背景议定书检查员
在开发过程中,您可以直接检查 MCP 工具调用结果 MCP 检查员。 。 。 .
您可以使用下列命令运行 :
npx @modelcontextprotocol/inspector npx -y mcp-remote@latest http://localhost:8787/mcp --header "\"Authorization: Bearer {INSERT_YOUR_PERSONAL_API_KEY_HERE}\""
或者,您可以在 MCP 检查器中使用以下配置 :
使用运输类型 STDIO。 。 。 .
命令 :
npx
参数 :
-y mcp-remote@latest http://localhost:8787/mcp --header "Authorization: Bearer {INSERT_YOUR_PERSONAL_API_KEY_HERE}"
通过 npx 使用的 CLI
您可以使用 npx 通过 stdio 本地运行 PostHog MCP 服务器,类似于 Salesforce MCP 实例.
# Fast path inside containers (no -y):
npx @andrew_eragon/mcp-server-posthog
# Outside containers, allow auto-confirm with -y:
npx -y @andrew_eragon/mcp-server-posthog
环境变量:
POSTHOG_REMOTE_MCP_URL(默认 :https://mcp.posthog.com/mcp(中文(简体) )POSTHOG_API_TOKEN(要求;与Authorization: Bearer <token>(中文(简体) )POSTHOG_FEATURES(可选逗号分隔列表以限制工具)POSTHOG_SESSION_ID(可选会话标识符)
旗帜( 覆盖封口 ) :
npx -y @andrew_eragon/mcp-server-posthog \
--token "$POSTHOG_API_TOKEN" \
--url "https://mcp.posthog.com/mcp" \
--features "org,insights" \
--session "abcd-1234"
这个CLI连接到主机 PostHog MCP mcp-remote,插入认证头并转发 /sse 视需要而定。 它适合期待MCP stdio服务器的工具.