Chuyển đến nội dung chính
TOSE
VIEN

MCP · OpenAPI · Skills

TOSE và MCP

MCP server của TOSE đã chạy tại https://app.tose.sh/mcp (Streamable HTTP). Thêm nó vào MCP client, đăng nhập TOSE và duyệt các scope được yêu cầu: client tự lo OAuth 2.1 với PKCE và tự đăng ký, nên không cần API key. Sau đó agent có 8 tool để xem project, deployment, log và incident, deploy và rollback.

Trạng thái

MCP connector
Có sẵn
Remote MCP server tại https://app.tose.sh/mcp với 8 tool: 6 chỉ đọc và 2 thay đổi deployment.
Kết nối một chạm và OAuth cho agent
Có sẵn
OAuth 2.1 với PKCE và đăng ký client động: đăng nhập TOSE rồi duyệt; không phải sao chép API key.
Skills trong MCP client
Coming soon
Các tool MCP không bao gồm skills. Đọc Skills catalogue công khai hoặc cài skill bằng CLI.
Mô tả OpenAPI của TOSE API
Có sẵn
File công khai do API production phục vụ, xem bên dưới.
Skills catalogue công khai
Có sẵn
Danh sách JSON công khai các hướng dẫn cho agent, xem bên dưới. Đây là tài liệu, không phải MCP server.

Kết nối

  1. Thêm một remote MCP server (HTTP) với URL https://app.tose.sh/mcp vào MCP client của bạn.
  2. Đăng nhập TOSE trong cửa sổ trình duyệt mà client mở ra và duyệt các scope được yêu cầu.
  3. Agent có thể gọi các tool TOSE bên dưới, trong phạm vi scope bạn đã duyệt.

Claude Code:

claude mcp add --transport http tose https://app.tose.sh/mcp

Client khác (Claude Desktop, Cursor, Codex…): thêm một remote hoặc HTTP MCP server với cùng URL. Hướng dẫn cài MCP trên docs.tose.sh

Tool chỉ đọc

  • list_projects
  • get_deployment_status
  • inspect_deployment
  • read_logs
  • list_incidents
  • inspect_incident

Tool thay đổi deployment (cần scope ghi)

  • deploy_project
  • rollback_deployment

Scope

  • workspace:read
  • projects:read
  • deployments:read
  • logs:read
  • deployments:write
  • deployments:execute
  • deployments:rollback

Ba thứ khác nhau

  • MCP connector Có sẵn: server mà MCP client kết nối bằng OAuth, tại https://app.tose.sh/mcp.
  • Skills catalogue và OpenAPI Có sẵn: tài liệu công khai để đọc hoặc tải về; không cần đăng nhập và không kết nối vào tài khoản của bạn.
  • WebMCP Coming soon: các tool chỉ đọc mà một trang web cung cấp cho agent trong trình duyệt. Cần bật cờ thử nghiệm của trình duyệt và đang tắt trên site này; không phải MCP server và không phải điểm kết nối.

Tài liệu API công khai

Cả hai đều công khai và do API production phục vụ.

API key đặt trong header X-API-Key, không bao giờ trong URL. Key có thể mang scope; yêu cầu vượt scope sẽ lỗi insufficient_scope.

Cách khác: CLI với API key

Claude Code, Codex, Cursor và các agent khác chạy được lệnh terminal cũng dùng được TOSE CLI. Mọi lệnh nhận --json và trả kết quả agent đọc được. Key được đọc từ TOSE_API_KEY nên không bao giờ phải xuất hiện trong cuộc trò chuyện.

npm install -g @tosesh/tose
tose whoami --json
tose deploy my-workspace/my-app --json
tose status my-workspace/my-app --json
tose logs my-workspace/my-app -n 100

Cập nhật

Thay đổi của MCP server và các tool được ghi trong nhật ký thay đổi. Nhật ký thay đổi