Kết nối agent qua MCP

Thông tin chung

URL MCP server: https://thecollective.io.vn/mcp/v1.
Giao thức: MCP qua HTTP.
Xác thực: OAuth 2.1. Agent chỉ cần URL, không cần khai báo client_id / client_secret. Lần đầu kết nối, trình duyệt mở màn hình đồng ý: đăng nhập tài khoản The Collective rồi bấm Authorize.

Mọi thao tác của agent chạy theo quyền của tài khoản đã đăng nhập: agent chỉ thấy tổ chức, dự án và task mà bạn được xem.

Claude Code

claude mcp add --transport http the-collective https://thecollective.io.vn/mcp/v1

Hoặc khai báo trong .mcp.json của dự án:

{
  "mcpServers": {
    "the-collective": {
      "type": "http",
      "url": "https://thecollective.io.vn/mcp/v1"
    }
  }
}

Sau đó chạy /mcp trong phiên Claude Code, chọn the-collective → Authenticate.

Codex

codex mcp add the-collective --url https://thecollective.io.vn/mcp/v1
codex mcp login the-collective

Hoặc khai báo trong ~/.codex/config.toml:

[mcp_servers.the-collective]
url = "https://thecollective.io.vn/mcp/v1"

rồi chạy codex mcp login the-collective. Lệnh login mở trình duyệt để bạn đồng ý cấp quyền; token được Codex lưu riêng, không ghi vào config.toml.

Cursor

Thêm vào .cursor/mcp.json:

{
  "mcpServers": {
    "the-collective": {
      "url": "https://thecollective.io.vn/mcp/v1"
    }
  }
}

Cursor tự mở trình duyệt để bạn đồng ý cấp quyền.

VS Code (GitHub Copilot Chat)

Thêm vào .vscode/mcp.json:

{
  "servers": {
    "the-collective": {
      "type": "http",
      "url": "https://thecollective.io.vn/mcp/v1"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector, dán URL MCP ở trên rồi bấm Add.

Agent khác

Mọi agent hỗ trợ MCP qua HTTP và OAuth 2.1 (đăng ký client tự động) đều kết nối được bằng cùng một URL.

Sau khi kết nối

Đầu mỗi phiên, agent nên gọi lần lượt:

OverviewTool - nắm nguyên tắc làm việc với task.
ProfileTool - biết bạn là ai, thuộc tổ chức nào.
InboxTool - xem người khác vừa giao việc, sửa task của bạn hay nhắc tên bạn.

Muốn bắt đầu một task, dùng prompt work-on-task kèm mã task.