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

Slack MCP

Trạng thái

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

Dành cho ai​

Quản trị viên muốn bật Slack MCP cho tổ chức và thành viên muốn cho Agent thao tác trong Slack bằng quyền user của chính mình.

Cách hoạt động​

Slack connector dùng hosted MCP endpoint và OAuth user-centric của Slack:

MCP endpoint: https://mcp.slack.com/mcp
Authorization: https://slack.com/oauth/v2_user/authorize
Token endpoint: https://slack.com/api/oauth.v2.user.access

Flow dùng OAuth 2.0 PKCE. Flezi Galaxy lưu token theo cặp connector + user và không thay user token bằng bot token.

Thiết lập cho quản trị viên​

  1. Tạo hoặc mở Slack app và bật capability Slack MCP Server.

  2. Thêm các user scopes cần thiết cho Tools tổ chức muốn dùng.

  3. Đăng ký Redirect URL chính xác:

    https://<api-host>/api/v1/integrations/slack/callback

    Dùng URI do Backend trả trong trạng thái connector; <api-host> là host API, không mặc định là origin của SPA.

  4. Trong tab Slack MCP setup, nhập Slack Client ID và Slack Client Secret. Secret chỉ được lưu ở server và không bao giờ hiển thị lại trong response status.

  5. Đảm bảo workspace admin của Slack chấp thuận tích hợp nếu chính sách workspace yêu cầu.

Quản lý app credentials yêu cầu System Admin, Org Admin hoặc Workspace Admin. Client ID có thể được lưu trước, nhưng flow authorize sẽ không chạy cho đến khi Client Secret server-side khả dụng.

Kết nối tài khoản​

  1. Mở MCP Servers → chọn Slack connector.
  2. Trong tab Account & OAuth, kiểm tra requested user scopes.
  3. Nhấn Sign in with Slack và chấp thuận quyền.
  4. Kiểm tra workspace, Slack user ID và trạng thái Connected.
  5. Chạy Test Connection để khám phá Tools.

Mỗi thành viên phải authorize riêng. Disconnect tài khoản của bạn chỉ xóa token của bạn cho connector đó.

Tools và scopes​

Tools hiển thị trong Tools Explorer phụ thuộc vào endpoint và scopes mà Slack cấp. Các nhóm thường gặp gồm:

  • Tìm kiếm và đọc message/thread.
  • Liệt kê channel và conversation.
  • Gửi message vào channel hoặc thread.
  • Truy cập users, files, canvases hoặc lists khi app đã được cấp scope tương ứng.

Giữ danh sách scopes tối thiểu theo nhu cầu của tổ chức. Có thể cấu hình override scopes bằng SLACK-OAUTH-SCOPES ở Backend.

Xử lý lỗi​

  • Client Secret required: nhập secret ở tab setup; Slack code exchange cần secret server-side.
  • Needs OAuth: authorize tài khoản hiện tại trước khi Test Connection.
  • Bot token rejected: connector yêu cầu user token từ user OAuth flow, không phải xoxb- bot token.
  • 403 hoặc thiếu Tools: kiểm tra user scopes, capability Slack MCP Server và phê duyệt của workspace admin.
  • OAuth quay lại UI nhưng chưa Connected: chỉ oauth_result=success từ callback Backend mới là thành công; mcp_connected=1 một mình không đủ.

Liên quan​