跳到主要内容

signoz mcp

signoz mcp 为您管理 MCP 服务器: 其保存的配置, 背景 HTTP 服务器, 登录服务, 及其在 MCP 客户端的注册 。

npx signoz mcp config # asks for the settings in the terminal and saves them
npx signoz mcp config --env production --port 4000 # no prompts (scripts, CI): saves just these, keeps the rest
npx signoz mcp config --web # the same, in a local web form
npx signoz mcp install # pick Claude Code / Codex / OpenCode and register signoz-mcp (stdio) in them
npx signoz mcp install --client claude,opencode --force # no picker (scripts, CI); --force replaces an entry
npx signoz mcp uninstall # pick the clients to remove the 'signoz' entry from (no saved config needed)
npx signoz mcp start # start in the background (needs a saved config); prints the URL for `claude mcp add`
npx signoz mcp start --api-key other --port 4000 # one-off values, never saved
npx signoz mcp status # running or stopped (exit 3), URL, pid, uptime
npx signoz mcp stop
npx signoz mcp boot enable # start at every login; `boot disable` / `boot status`

signoz mcp config​

写入保存 .env (单位:千美元)配置) (中文(简体) ). 它有三个方法:

  • 在终点站 (默认). 它要求从保存的值开始,逐个设置。 密件被打入掩码: 输入保存保存的密件,以及 - 清净.
  • 带着旗帜 鉴于任何 --base-url, (中文). --api-key, (中文). --auth-token, (中文). --refresh-auth-token, (中文). --env 或 --port,它不问什么 并且只救那些。 没有终端,它需要它们。 一个传下来的秘密作为旗帜 留在你的壳体史上, 所以更喜欢迅速。
  • 网络形式 与 --web: 本地页面,在浏览器中打开(--no-open 只打印其 URL 。 一个空白的秘密 保存了保存的。

如果服务器正在运行, 它会说: 重新启动它来抓取更改 。 --config <file> (或 SIGNOZ_CONFIG)写另一个文件.

signoz mcp install​

通过运行每个客户端 --version,然后通过客户端自己的CLI注册 stdio 服务器,名称为 signoz编号 :

客户端命令它运行
Claude Codeclaude mcp add -s user
Codexcodex mcp add
OpenCodeopencode mcp add --global

注册命令是 node <package>/dist/mcp/cli.js 绝对路径, 没有证书 : 当客户端启动时, 服务器读取保存的文件( N)SIGNOZ_CONFIG 只有在 --config 命名另一个文件)。

每个发现的客户端开始勾选 。 一个已经有一个 signoz 标记条目 already installed, reinstalls 然后换掉 没有互动终端 --client 需要(claude, (中文). codex, (中文). opencode; 也在 WSL 内 claude@windows, (中文). codex@windows, (中文). opencode@windows),加: --force 替换条目。 --dry-run 打印命令而不是运行。

两者 install 和 uninstall 每个客户端的用户级(全局)配置。 项目范围条目从不触动.

signoz mcp uninstall​

以 signoz 条目,显示是否为 stdio 或 http,并删除该名称的任何条目: claude mcp remove -s user, (中文). codex mcp remove,用于 OpenCode (没有) remove)编辑其全局配置文件,只删除该密钥,保留注释和布局.

这是唯一的命令之外 signoz mcp config 运行时没有保存的配置,所以可以在配置消失后清理客户端。 --client 和 --dry-run 工作情况 install。 。 。 。

signoz mcp start, (中文). stop 和 status​

start 运行 HTTP 服务器脱落, 其pid 和日志输入 <config dir>/run/,并打印其 URL、日志文件和 claude mcp add 线条以注册它。 它需要一个保存的配置. --api-key, (中文). --base-url, (中文). --env 和 --port 仅为本次运行而覆盖, 并且从未保存 。 --foreground 相反,在目前进程中提供了服务。

status 打印服务器是否在运行,包括它的 URL、 pid 和 upptime, 并在不运行时使用代码 3 退出。 stop 请服务器通过代号守护关闭 POST /shutdown,并仅在失败时表示进程。

signoz mcp boot​

boot enable 安装当前用户在每次登录时启动服务器的服务, 因此不需要sudo :

业务办服务
链接系统化用户单元(在WSL上,启用在 /etc/wsl.conf页:1
马科斯a 发射代理
窗口登录任务

服务只读保存的配置 。 boot disable 把它删除 boot status 报告