Chuyển tới nội dung chính

MCP Connector và tích hợp Google/Slack

Trạng thái

Owner: TBD · Trạng thái: draft · Nguồn chuẩn: flezi.app.frontend.main/src/pages/McpServers.tsx, src/components/mcp-servers/

Dành cho ai​

Quản trị viên và thành viên muốn kết nối Agent với công cụ bên ngoài qua Model Context Protocol (MCP). Tên màn hình trong ứng dụng là MCP Connector.

Bạn làm được gì​

  • Thêm connector bằng Streamable HTTP, SSE (legacy) hoặc STDIO.
  • Chạy Test Connection để handshake và khám phá danh sách Tools.
  • Gắn connector vào Agent, chia sẻ connector theo Workspace hoặc direct user grant và quản lý quyền OAuth theo từng người dùng. Chia sẻ MCP trên toàn Organization hiện chưa được xác minh.
  • Kết nối các provider dựng sẵn Google Workspace và Slack bằng OAuth 2.0 PKCE.

Transport và trạng thái​

Transport / trạng tháiÝ nghĩa
Streamable HTTPTransport mặc định cho MCP HTTP hiện đại.
SSE (legacy)Transport SSE cho server cũ còn hỗ trợ giao thức này.
STDIOChạy process MCP bằng command trong môi trường runtime của dịch vụ. Command phải được cài đặt và service runtime phải tìm thấy executable.
ConnectedKết nối thành công và đã khám phá Tools.
Needs OAuthConnector yêu cầu bạn cấp quyền tài khoản trước khi test hoặc tải Tools. Trạng thái này có thể khác nhau giữa các thành viên.
Error / DisconnectedLần kết nối gần nhất thất bại hoặc connector chưa kết nối. Xem lỗi trên card rồi thử lại.

Thêm connector​

  1. Từ Sidebar, chọn MCP Servers và nhấn Add MCP Connector.
  2. Nhập tên hiển thị, URL/command và chọn transport:
    • Streamable HTTP: Dùng URL MCP; không nhập URL REST thông thường như /api/v1/....
    • SSE (legacy): Dùng endpoint SSE của MCP server.
    • STDIO: Nhập command và arguments. Có thể dùng biến ${ENV_VAR}; command/arguments được tách như shell tokens, nhưng không chạy qua shell.
  3. Nhấn Test Connection. Hệ thống sẽ khám phá Tools; một server không trả danh sách Tools trong khoảng 30 giây sẽ báo lỗi thay vì làm run chờ vô hạn.
  4. Kiểm tra danh sách Tools rồi nhấn Save.
  5. Trong Agent Builder, chọn connector đã được chia sẻ hoặc connector của bạn để bind vào Agent.
OAuth connector

Với connector có Needs OAuth, hãy hoàn tất Connect OAuth hoặc Sign in with Google/Slack trước khi Test Connection. Mỗi người dùng phải authorize riêng; token của bạn không được dùng chung với thành viên khác.

Google Workspace và Slack​

  • Google Workspace MCP: cấu hình Google Cloud OAuth App hoặc upload token.json cho tài khoản hiện tại; Tools gồm Gmail, Calendar và Drive theo connector được chọn.
  • Slack MCP: cấu hình Slack Client ID/Client Secret ở cấp tổ chức rồi authorize tài khoản Slack cá nhân; không dùng bot token thay cho user token.

Lỗi thường gặp​

  • STDIO command not found: Cài package/executable trong image hoặc service host; kiểm tra PATH mà service runtime sử dụng, không chỉ PATH của terminal tương tác.
  • Needs OAuth: Mở tab Account & OAuth, authorize tài khoản rồi test lại. Thành viên được chia sẻ connector vẫn phải authorize riêng.
  • Test timeout: Kiểm tra URL, transport và health của server. Runtime giới hạn discovery ở 30 giây.
  • OAuth quay về UI nhưng chưa Connected: Chỉ oauth_result=success do Backend trả về mới được coi là thành công; tham số mcp_connected=1 một mình không đủ.

Liên quan​