Common Room và Claude: Hướng dẫn Kết nối

Common Room là nền tảng community intelligence dẫn đầu thị trường — tổng hợp tín hiệu từ hàng chục kênh (GitHub, Slack, Discord, LinkedIn, Twitter, forum, email) thành một cái nhìn thống nhất về cộng đồng của bạn. Khi kết hợp với Claude qua MCP, Common Room không chỉ là nơi xem dữ liệu — mà trở thành nguồn tri thức mà Claude có thể truy vấn, phân tích và hành động dựa trên đó.

Bài viết này giải thích kiến trúc tích hợp, cách thiết lập MCP server của Common Room và cách sử dụng connector lịch tùy chọn để tối đa hóa giá trị từ plugin.

Common Room MCP — Nguồn dữ liệu cốt lõi

Khác với các plugin khác sử dụng nhiều connector song song, plugin Common Room được xây dựng xung quanh một nguồn dữ liệu chính: MCP server của Common Room tại địa chỉ mcp.commonroom.io/mcp. Đây là server do Common Room vận hành trực tiếp — đảm bảo dữ liệu luôn được cập nhật và API luôn tương thích với nền tảng.

Server này phải được kết nối và xác thực thành công thì plugin mới hoạt động. Tất cả skill và lệnh trong plugin đều phụ thuộc vào Common Room MCP làm nguồn dữ liệu nền tảng.

Danh sách connector

Đây là plugin duy nhất trong bộ knowledge-work plugins có kiến trúc connector tối giản — Common Room là trung tâm, lịch là lớp bổ sung tùy chọn. Sự đơn giản này là có chủ đích: Common Room đã tổng hợp tín hiệu từ nhiều kênh, nên Claude không cần kết nối trực tiếp với từng kênh đó nữa.

Cách thiết lập Common Room MCP

Để kết nối Claude với Common Room, bạn cần thực hiện các bước sau:

Bước 1 — Tạo API key trong Common Room. Đăng nhập vào Common Room, vào phần Settings, chọn API Keys và tạo key mới với quyền đọc dữ liệu cần thiết. Lưu API key này ở nơi an toàn — bạn sẽ cần dùng trong bước tiếp theo.

Bước 2 — Cấu hình MCP server trong file .mcp.json. Thêm entry sau vào file cấu hình:

{
  "mcpServers": {
    "commonroom": {
      "url": "https://mcp.commonroom.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_COMMONROOM_API_KEY"
      }
    }
  }
}

Thay YOUR_COMMONROOM_API_KEY bằng API key thực tế của bạn. Không commit file này lên git repository nếu chứa key thật — sử dụng biến môi trường hoặc secret manager.

Bước 3 — Xác minh kết nối. Sau khi cấu hình, yêu cầu Claude thực hiện một truy vấn đơn giản: "Liệt kê 10 thành viên cộng đồng hoạt động nhất trong tuần này." Nếu Claude trả về dữ liệu thực tế từ Common Room, kết nối đã thành công.

Connector lịch — Tùy chọn nhưng có giá trị cao

Plugin Common Room sử dụng connector lịch trong hai skill cụ thể:

Skill call-prep — Chuẩn bị cuộc gọi tự động

Khi bạn yêu cầu Claude chuẩn bị cho một cuộc gọi sắp tới, nếu có connector lịch, Claude sẽ tự động lấy tên người tham dự từ calendar event, tra cứu hồ sơ của họ trong Common Room (hoạt động cộng đồng, repo GitHub đã contribute, bài viết đã đăng, sentiment gần đây) và tổng hợp thành brief chuẩn bị cuộc gọi.

Nếu không có connector lịch, skill này vẫn hoạt động — Claude sẽ hỏi bạn tên người tham dự trực tiếp thay vì lấy tự động từ lịch. Không có gì bị mất, chỉ là bước thủ công hơn một chút.

Skill weekly-prep-brief — Tổng hợp tuần làm việc

Skill này tổng hợp báo cáo đầu tuần bao gồm: các cuộc họp quan trọng sắp tới với người ngoài tổ chức, hồ sơ cộng đồng của từng người tham dự, và tín hiệu đáng chú ý từ cộng đồng trong tuần trước. Khi có connector lịch, Claude tự động lấy danh sách cuộc họp 7 ngày tới; không có lịch, bạn cần cung cấp danh sách này thủ công.

Cách thiết lập connector lịch

Connector lịch là tùy chọn nhưng được khuyến nghị để tối đa hóa tự động hóa. Có hai lựa chọn:

Google Calendar: Cài đặt Google Calendar MCP server và xác thực bằng OAuth 2.0. Server sẽ có quyền đọc danh sách sự kiện trong lịch của bạn.

Outlook / Microsoft 365: Sử dụng Microsoft 365 MCP server — server này bao gồm cả email, lịch và Teams trong một package duy nhất. Xác thực qua Azure Active Directory.

Sau khi cài đặt, thêm server vào file .mcp.json bên cạnh Common Room MCP:

{
  "mcpServers": {
    "commonroom": {
      "url": "https://mcp.commonroom.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_COMMONROOM_API_KEY"
      }
    },
    "google-calendar": {
      "command": "npx",
      "args": ["-y", "@google/mcp-server-calendar"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

Các use case chính của plugin Common Room

Phân tích cộng đồng và tín hiệu tăng trưởng

Common Room tổng hợp tín hiệu từ GitHub, Slack, Discord, LinkedIn và nhiều kênh khác. Claude có thể truy vấn và phân tích những tín hiệu này để trả lời các câu hỏi như: "Công ty nào đang show high intent signals trong tuần này?", "Developer nào vừa star repo lần thứ hai và xứng đáng được reach out?", "Chủ đề nào đang hot trong cộng đồng Discord của chúng ta?"

Chuẩn bị cuộc gọi từ dữ liệu cộng đồng

Đây là điểm khác biệt lớn nhất của plugin Common Room so với các CRM thông thường. Trước buổi gặp với một developer hoặc champion cộng đồng, Claude có thể cung cấp bức tranh đầy đủ: họ đã contribute những gì vào project, họ đặt câu hỏi về vấn đề gì, họ có sentiment tích cực hay tiêu cực gần đây, và họ đang ở giai đoạn nào trong hành trình với sản phẩm của bạn. Đây là mức độ personalization mà không một CRM truyền thống nào có thể cung cấp.

Báo cáo sức khỏe cộng đồng và tín hiệu PLG

Claude có thể tổng hợp báo cáo định kỳ về các chỉ số cộng đồng: số thành viên mới, tỷ lệ giữ chân, mức độ tương tác theo kênh và xu hướng sentiment. Với các công ty Product-Led Growth (PLG), Claude còn giúp xác định ai đang trở thành champion nội bộ, công ty nào có dấu hiệu expansion, và thời điểm phù hợp để sales team reach out dựa trên tín hiệu sử dụng sản phẩm.

Fallback graceful khi không có lịch

Một điểm mạnh trong thiết kế plugin là cả hai skill sử dụng lịch (call-prep và weekly-prep-brief) đều có cơ chế fallback rõ ràng. Khi không phát hiện calendar connector, Claude tự động chuyển sang hỏi người dùng thủ công — không crash, không báo lỗi khó hiểu. Người dùng có thể cung cấp tên hoặc email của người tham dự, và Claude tiếp tục tra cứu trong Common Room như bình thường.

Điều này có nghĩa là bạn có thể bắt đầu sử dụng plugin ngay lập tức chỉ với Common Room MCP, và thêm connector lịch sau khi đã quen với workflow.

Tùy chỉnh và mở rộng

Common Room MCP server là server được quản lý bởi Common Room — bạn không cần tự vận hành hoặc bảo trì. Khi Common Room cập nhật API, MCP server cũng được cập nhật tương ứng.

Nếu bạn muốn mở rộng plugin với các nguồn dữ liệu bổ sung (ví dụ: kết nối thêm CRM để làm giàu hồ sơ từ Common Room), bạn có thể thêm MCP server của CRM vào file cấu hình. Plugin được thiết kế để có thể mở rộng — miễn là MCP server mới được cấu hình đúng, Claude có thể sử dụng dữ liệu từ nhiều nguồn trong cùng một workflow.

Bước tiếp theo

Sau khi kết nối Common Room MCP thành công, bắt đầu với skill weekly-prep-brief vào sáng thứ Hai để trải nghiệm ngay giá trị của plugin. Sau đó thử skill call-prep trước buổi gặp khách hàng hoặc cuộc gọi với developer quan trọng. Truy cập Thư viện Ứng dụng để xem thêm các plugin tích hợp và hướng dẫn sử dụng nâng cao.

Bài viết liên quan

• Common Room và Claude: Tổng quan Tích hợp
• Claude Hỗ trợ Khách hàng: Hướng dẫn Kết nối Công cụ
• Claude Marketing: Hướng dẫn Kết nối Công cụ
• Lệnh Claude: Báo cáo Tuần với Common Room
• Claude Bán hàng: Hướng dẫn Kết nối Công cụ