本页说明如何在 OpenAI Responses API 中接入已经启动的 ShardingSphere-MCP HTTP Server。ShardingSphere-MCP 是 Apache ShardingSphere 提供的 MCP Server，用于把数据库元数据访问、受控 SQL 查询和数据库治理能力暴露给支持 MCP 的 AI 客户端和平台。
allowed_tools、require_approval 或 OAuth 参数约束使用范围。database_gateway_validate_proxy_connectivity 对已经配置的 runtime database 进行接入前校验。Streamable HTTP 或 HTTP/SSE。在 Responses API 请求中，把 ShardingSphere-MCP 作为 tools 中的一个 mcp 工具传入。最小示例如下：
from openai import OpenAI
client = OpenAI()
response = client.responses.create(
model="gpt-5",
tools=[
{
"type": "mcp",
"server_label": "shardingsphere",
"server_url": "https://example.com/mcp",
"allowed_tools": [
"database_gateway_search_metadata",
"database_gateway_validate_proxy_connectivity",
],
}
],
input="Use ShardingSphere-MCP to inspect the tables in the logic database.",
)
配置时建议关注这些字段：
server_label：当前 MCP Server 的标识名称，后续工具调用和审批事件会引用这个名称。server_url：位于 ShardingSphere-MCP 前方、已受保护的远程 HTTP 地址。allowed_tools：可选。用于只导入 ShardingSphere-MCP 暴露工具中的一个子集，适合先从只读工具和预检工具开始。require_approval：可选。默认会触发审批请求。只有在你已经审查过工具范围并接受自动调用时，才应关闭审批。authorization：可选。仅当受保护的远程 endpoint 或网关需要 OAuth 或 Bearer 访问令牌时，在这里传入认证信息。
该字段不会为 ShardingSphere-MCP 内置 HTTP Server 启用认证能力。识别成功：
mcp_list_tools 输出项。mcp_approval_request 输出项，此时需要按 OpenAI 审批流程补发 mcp_approval_response。调用成功：
<logic-database> 中有哪些表。orders 表的列和索引。database_gateway_validate_proxy_connectivity。mcp_list_tools、审批流程或最终查询结果按预期返回时，说明接入已经生效。如果接入失败，优先检查：
server_url 是否为 OpenAI 平台可访问且已受保护的远程地址，而不是本地 127.0.0.1 地址或直接暴露的未认证内置 HTTP Server。mcp_list_tools；如果没有，先排查远程地址和服务可用性。mcp_approval_request，以及后续是否正确补发了 mcp_approval_response。STDIO 进程。allowed_tools。