> ## Documentation Index
> Fetch the complete documentation index at: https://coding-1afcb9be.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始

> 安装、启动和验证 Coding Tools MCP 的最短路径。

# 快速开始

本页给出从安装到启动的最短路径，默认值来自当前代码实现。

## 前置要求

* Python `>=3.11`
* 支持 stdio 或 Streamable HTTP 的 MCP 客户端
* 一个你愿意暴露给编码工具的工作区目录

## 用 HTTP 启动

```bash theme={null}
python -m pip install coding-tools-mcp
cd /path/to/workspace
coding-tools-mcp
```

默认监听地址是：

```text theme={null}
http://127.0.0.1:8000/mcp
```

也可以显式指定工作区：

```bash theme={null}
coding-tools-mcp --workspace /path/to/workspace
```

## 用 stdio 启动

如果 MCP 客户端负责拉起服务进程，使用 `--stdio`：

```bash theme={null}
coding-tools-mcp --stdio --workspace /path/to/workspace
```

stdio 传输从 stdin 读取逐行 JSON-RPC，并把响应写到 stdout。

## 验证 HTTP 元数据

HTTP 模式下可以先检查 `/mcp`：

```bash theme={null}
curl http://127.0.0.1:8000/mcp
```

响应应包含服务器名称、协议版本、当前工具 profile 和工具列表信息。

## 第一次客户端调用

客户端完成 MCP `initialize` 后，调用 `tools/list`。默认 `full` profile 会暴露文件、搜索、补丁、命令、Git、权限和图片工具。`read-only` profile 会隐藏 `apply_patch`、`exec_command`、`write_stdin`、`kill_session`、`set_default_cwd` 和 `request_permissions` 等会改变状态的工具。

## 远程绑定需要鉴权

本地 loopback 可以无鉴权运行。绑定到非 loopback 地址时，代码要求 Bearer token 或 OAuth，除非显式配置 `noauth`：

```bash theme={null}
coding-tools-mcp --host 0.0.0.0 --auth-token "$CODING_TOOLS_MCP_AUTH_TOKEN"
```

```bash theme={null}
coding-tools-mcp --host 0.0.0.0 --oauth-mode
```

`CODING_TOOLS_MCP_AUTH_MODE=noauth` 只应放在已经由其他可信层保护的网络边界后面。

## 下一步

* 看 **安装与配置** 了解 CLI 参数和环境变量。
* 看 **客户端接入** 配置 MCP 客户端。
* 看 **故障排查** 处理连接、鉴权、权限和补丁问题。