# 故障排查

> 常见的启动和连接问题。

规范地址: https://keta1930.github.io/icml2026-mcp/zh/docs/operations/troubleshooting



## `Not Acceptable: Client must accept text/event-stream` [#not-acceptable-client-must-accept-textevent-stream]

`/mcp` 是 Streamable HTTP MCP 端点，不是网页。浏览器普通请求没有携带所需的 `Accept` header，因此返回这个错误是正常的。应在 MCP 客户端中添加该地址。只检查传输层时可以使用：

```bash
curl -i -H 'Accept: text/event-stream' \
  https://icml.agent4sci.com:20441/mcp
```

## Readiness 返回 503 [#readiness-返回-503]

检查 Milvus 是否健康、`current.json` 是否存在，以及对应 collection 是否存在：

```bash
docker compose -f deploy/compose.yaml -f deploy/milvus.compose.yaml ps
docker compose -f deploy/compose.yaml -f deploy/milvus.compose.yaml logs icml-mcp standalone
```

## 搜索返回 embedding 错误 [#搜索返回-embedding-错误]

确认应用容器可以读取 secret 文件，并且该 key 能在北京地域调用 `qwen3.7-text-embedding`。