将 Trustvice 添加为远程 HTTP MCP 服务器,并通过 /mcp 命令使用 OAuth 登录。
bash
claude mcp add --transport http trustvice https://mcp.trustvice.com/mcp
阅读文档
网页版与桌面版的 Claude 应用
AI 客户端托管式的服务
通过带 PKCE 的 OAuth 以自定义连接器方式连接。
Claude
设置 → 连接器 → 添加自定义连接器
名称: Trustvice
URL: https://mcp.trustvice.com/mcp
然后: 连接,并使用您的 Trustvice 账户登录
阅读文档从 mcp.json 中读取服务器配置,可用于全部项目或某一个项目,然后通过 OAuth 登录,或者从您的环境变量中发送密钥。
~/.cursor/mcp.json
{
"mcpServers": {
"trustvice": {
"url": "https://mcp.trustvice.com/mcp"
}
}
}
阅读文档在开发者模式下通过 OAuth 以自定义连接器的形式进行连接,前提是您的套餐以及工作区管理员都允许这样做。
ChatGPT
设置 → 连接器 → 高级 → 开发者模式
创建 → 名称: Trustvice
MCP 服务器 URL: https://mcp.trustvice.com/mcp
身份验证: OAuth → 创建 → 连接
阅读文档
OpenAI Responses API
AI 客户端托管式的服务
在脚本中把 Trustvice 用作远程 MCP 工具;请将 require_approval 保持为 always,让人工批准每个操作。
json
{
"type": "mcp",
"server_label": "trustvice",
"server_url": "https://mcp.trustvice.com/mcp",
"authorization": "<OAuth access token>",
"require_approval": "always"
}
阅读文档
VS Code 以及其他各类 MCP 客户端
AI 客户端托管式的服务
任何支持带自定义请求头的远程 HTTP 服务器的客户端都可以连接。请随凭据一起发送 X-Workspace-Id 请求头。
MCP
type http (streamable HTTP)
url https://mcp.trustvice.com/mcp
header Authorization: Bearer <credential>
header X-Workspace-Id: ws_…
阅读文档@trustvice/verify(尚未发布)
SDK 与各类程序库目前还尚未发布
使用您传入的密钥集验证签名记录,不发起网络请求。尚未发布到 npm 注册表;验证页面现已可用。
ts
import { verifyArtifactWithKeys } from "@trustvice/verify";
const verdict = await verifyArtifactWithKeys(receipt, jwks);
console.log(verdict.ok ? verdict.kind : verdict.reason);
打开验证页面Agentic API
API 与技术规范托管式的服务
每个已声明的操作都是一次普通 HTTP POST,与 MCP 服务器投射为工具的目录相同。
bash
curl -sS -X POST https://api.trustvice.com/api/v1/actions/trustactor.runs.list \
-H "Authorization: Bearer $TRUSTVICE_TOKEN" \
-H "X-Workspace-Id: ws_…" \
-H "Content-Type: application/json" -d '{}'
阅读文档已注册操作的公开、自描述列表,可匿名获取。
bash
curl -s https://api.trustvice.com/api/v1/actions
阅读文档OpenAPI 3.1 规范文档
API 与技术规范已发布
在 /openapi.json 以及 well-known 路径之下,描述操作 API、它所使用的数据结构,以及各种安全方案。
bash
curl -s https://trustvice.com/openapi.json -o trustvice-openapi.json
# also at /.well-known/openapi.json
阅读文档为回执签名的 Ed25519 公钥,以 JSON 密钥集形式提供。
bash
curl -sSL https://trustvice.com/.well-known/receipt-keys.json
打开文件一份涵盖整个网站以及每一个文档页面的纯文本地图,让语言模型能够自行选择它所要阅读的内容。
GET
https://trustvice.com/llms.txt
打开文件一份专门为编程助手准备的 Markdown 文档,其中包含各个主机、身份验证方式,以及每一个操作和对应的示例。
GET
https://trustvice.com/AGENTS.md
打开文件server.json 和 tools.json 描述了端点、各种身份验证模式以及完整的工具列表,完全无需建立任何连接即可读取。
GET
https://trustvice.com/.well-known/mcp/server.json
https://trustvice.com/.well-known/mcp/tools.json
打开文件网关智能体的 DID、传输方式、身份验证以及每个操作一项能力,也可在 a2a.json 获取。
GET
https://trustvice.com/.well-known/agent-card.json
https://trustvice.com/.well-known/agents.json
打开文件OpenID 与授权服务器元数据,客户端可据此找到端点并执行 PKCE 流程。
GET
https://trustvice.com/.well-known/openid-configuration
https://trustvice.com/.well-known/oauth-authorization-server
打开文件
ChatGPT 的应用清单
各类发现文件仅提供清单文件
为 ChatGPT 连接器描述各项操作以及 OAuth 端点,同时也可以在 ai-plugin.json 中获取。
GET
https://trustvice.com/.well-known/chatgpt-app.json
打开文件
Gemini 扩展程序的清单文件
各类发现文件仅提供清单文件
以函数声明的形式,为 Gemini 的各类扩展工具描述各项操作。相关的安装步骤目前还没有任何正式的文档说明。
GET
https://trustvice.com/.well-known/gemini-extension.json
打开文件
Perplexity 连接器的清单文件
各类发现文件仅提供清单文件
为 Perplexity 连接器描述每一个操作及其对应的 HTTP 端点。相关的安装步骤目前还没有任何文档说明。
GET
https://trustvice.com/.well-known/perplexity-connector.json
打开文件
Claude 连接器的清单文件
各类发现文件仅提供清单文件
为 Claude 连接器指明 MCP 端点以及 OAuth 的各项设置。有正式文档说明的接入方式,是上方所介绍的自定义连接器。
GET
https://trustvice.com/.well-known/claude-cowork.json
打开文件将自然语言意图映射到对应的操作 ID,并为每一项都提供 MCP 和 REST 端点,以及一个相应的安全等级。
GET
https://trustvice.com/.well-known/nlweb.json
打开文件清单文件描述 Agentic API 的操作目录,其中一些仍保留较旧的表述,例如审计日志操作、被列为范围的权限名称,以及被描述为必需的 DPoP。当文件与文档不一致时,以文档为准。