---
title: "同步 MCP 工具目录"
method: POST
path: "/mcp-services/{id}/metadata/refresh"
tags: ["MCP服务"]
---

# 同步 MCP 工具目录

`POST /mcp-services/{id}/metadata/refresh`

显式连接上游并原子替换完整目录。OAuth 服务写入当前用户的快照，Viewer 及以上可调用；静态认证写入租户共享快照，需要 Admin。

## Path parameters

- `id` string, required

## Response `200`

同步后的目录快照

- object

## Other responses

- `400` — 目录不完整或校验失败
- `401` — OAuth 目录缺少授权主体
- `403` — 静态认证目录需要管理员刷新
- `404` — 服务不存在
- `409` — 刷新期间连接配置已变更
- `503` — 元数据存储不可用

## Changes

- **2026-09-09** `1b7129ddfcde` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tencentblueking/apis/weknora-api/changes/mcp-services/:id/metadata/refresh/post.md)

---

[API](https://skmtc.dev/tencentblueking/apis/weknora-api.md) · [All operations](https://skmtc.dev/tencentblueking/apis/weknora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tencentblueking/apis/weknora-api/revisions/710d29c05955?raw)