MentionBird

npx add-mcp 'https://mcp.mentionbird.ai/mcp'

Hầu hết ứng dụng AI kết nối với MentionBird bằng cách đăng nhập: bạn cung cấp cho ứng dụng một địa chỉ, đăng nhập bằng tài khoản MentionBird rồi chọn một không gian làm việc. Bạn không cần tạo hay dán khóa. Claude, Claude Code và Codex kết nối theo cách này.

Địa chỉ này giống nhau với mọi người:

https://mcp.mentionbird.ai/mcp

MentionBird cũng có các bước tương tự, với tên không gian làm việc của bạn được điền sẵn: nhấp vào MCP trong thanh bên rồi mở thẻ Connect an AI app. ChatGPT có bài viết riêng — xem Kết nối MentionBird với ChatGPT.

Lần đầu kết nối, ứng dụng sẽ mở trang đăng nhập MentionBird trong trình duyệt. Đăng nhập, sau đó:

1. Chọn không gian làm việc. Kết nối chỉ đọc không gian làm việc đó, không đọc bất kỳ nội dung nào khác. Không gian làm việc có gói không bao gồm quyền truy cập MCP sẽ hiển thị mờ đi.
2. Quyết định có bật Allow changes hay không. Nếu được đánh dấu, ứng dụng có thể thêm thương hiệu và lời nhắc. Nếu không được đánh dấu, ứng dụng chỉ có thể đọc. Dù thế nào, ứng dụng cũng không thể chỉnh sửa hoặc xóa bất cứ thứ gì.
3. Nhấp vào Allow.

Bạn sẽ được đưa trở lại ứng dụng. Từ đó, ứng dụng sẽ luôn đăng nhập và tự gia hạn quyền truy cập trong nền.

Claude

Cách này hoạt động trên Claude phiên bản web, ứng dụng máy tính và Cowork.

1. Mở Settings → Connectors rồi nhấp vào Add custom connector.
2. Đặt tên là MentionBird — thêm tên không gian làm việc nếu bạn sẽ kết nối nhiều không gian — rồi dán địa chỉ ở trên. Giữ nguyên các tùy chọn đăng nhập mà Claude phát hiện.

Với gói Claude Team hoặc Enterprise, trước tiên chủ sở hữu cần thêm trình kết nối trong Organization settings → Connectors. Sau đó, mỗi thành viên nhấp vào Connect trên trình kết nối đó và đăng nhập bằng tài khoản MentionBird của riêng mình.

Claude Code

Chạy hai lệnh sau:

claude mcp add --scope user --transport http mentionbird https://mcp.mentionbird.ai/mcp

Thẻ Connect an AI app có các lệnh tương tự, kèm tên không gian làm việc của bạn — hãy sao chép từ đó nếu bạn sẽ kết nối nhiều không gian. Nếu sau này Claude Code báo MentionBird cần xác thực, hãy chạy /mcp, chọn mục MentionBird rồi chọn Authenticate.

Codex

codex mcp add mentionbird --url https://mcp.mentionbird.ai/mcp

Nếu Codex báo các công cụ của MentionBird không khả dụng, codex mcp login mentionbird sẽ đăng nhập lại cho bạn.

Cho phép ứng dụng thực hiện thay đổi sau này

Nếu bạn không đánh dấu Allow changes, bạn có thể bật tùy chọn này bất cứ khi nào cần:

• Claude và Claude Code sẽ yêu cầu bạn đăng nhập lại vào lần đầu cần thêm nội dung — hãy đánh dấu tùy chọn đó khi ấy.
• Codex giữ nguyên quyền truy cập bạn đã chọn khi đăng nhập. Chạy lại codex mcp login mentionbird và đánh dấu tùy chọn này. Nếu Codex vẫn từ chối thay đổi tiếp theo, hãy yêu cầu lại.

Kết nối nhiều không gian làm việc

Mỗi kết nối chỉ đọc một không gian làm việc. Để kết nối thêm không gian khác, hãy chuyển sang không gian đó trong MentionBird rồi làm theo các bước trong thẻ Connect an AI app riêng của không gian đó, nơi tên đã được điền sẵn. Đặt tên mỗi mục theo không gian làm việc — mentionbird-acme, mentionbird-globex — để bạn và trợ lý dễ phân biệt.

Claude chỉ giữ một trình kết nối cho mỗi địa chỉ, vì vậy để kết nối không gian làm việc thứ hai trong Claude, hãy dùng địa chỉ có thêm tên không gian làm việc ở cuối, chẳng hạn https://mcp.mentionbird.ai/mcp?workspace=globex. Thẻ Connect an AI app hiển thị địa chỉ chính xác cho từng không gian làm việc.

Đã kết nối bằng khóa API?

Hãy xóa mục cũ trước khi thêm mục mới, nếu không các công cụ của MentionBird sẽ xuất hiện hai lần. Trong Claude Code, đó là claude mcp remove mentionbird, còn trong Codex là codex mcp remove mentionbird — hoặc tên bạn đã đặt cho mục đó. Sau đó, thu hồi khóa trong thẻ Manage access nếu không còn nơi nào khác sử dụng khóa này.

Cursor và các ứng dụng khác

Cursor và các ứng dụng MCP khác không được liệt kê ở trên kết nối bằng khóa API: dùng cùng địa chỉ đó, đồng thời gửi khóa dưới dạng bearer token.

Trong Cursor, tạo .cursor/mcp.json trong dự án — hoặc ~/.cursor/mcp.json để dùng ở mọi nơi — với nội dung sau:

{"mcpServers": {"mentionbird": {"url": "https://mcp.mentionbird.ai/mcp", "headers": {"Authorization": "Bearer YOUR_API_KEY"}}}}

Thay YOUR_API_KEY bằng khóa của bạn, khởi động lại Cursor rồi tìm chấm trạng thái màu xanh lá trong Settings → MCP.

Mọi ứng dụng đọc tệp cấu hình đều cần cùng hai giá trị: địa chỉ và tiêu đề Authorization: Bearer chứa khóa của bạn. Không đưa các tệp đó vào kho lưu trữ hoặc ảnh chụp màn hình — khóa là mật khẩu để truy cập dữ liệu của bạn.

Claude cũng có thể kết nối bằng khóa, và thẻ Connect an AI app có hướng dẫn các bước đó. Tuy nhiên, đăng nhập đơn giản hơn và giúp giữ bí mật không nằm trong tệp cấu hình.

Kiểm tra kết nối

Hãy hỏi điều gì đó mà chỉ tài khoản của bạn mới có thể trả lời. "Tôi đang theo dõi những thương hiệu nào?" là phép thử đơn giản nhất.

Nếu không kết nối được

Hãy lần lượt thực hiện các bước sau:

1. Kiểm tra không gian làm việc. Nếu không gian đó hiển thị mờ trên màn hình đăng nhập, gói của không gian đó không bao gồm quyền truy cập MCP — trang giá cho biết những gói nào có quyền này.
2. Đăng nhập lại. Trong Claude, nhấp vào Connect trên trình kết nối. Trong Claude Code, chạy /mcp rồi chọn Authenticate. Trong Codex, chạy codex mcp login.
3. Kiểm tra xem kết nối có bị ngắt hay không. Kết nối kết thúc khi có người ngắt kết nối, khi bạn bị xóa khỏi không gian làm việc hoặc sau một thời gian dài không sử dụng. Đăng nhập lại sẽ tạo kết nối mới. Xem Xem và ngắt kết nối các ứng dụng đã kết nối.
4. Khởi động lại ứng dụng. Hầu hết ứng dụng đọc danh sách trình kết nối khi khởi động.

Nếu dùng khóa API, lỗi xác thực có nghĩa là khóa chưa đầy đủ, đã bị thu hồi hoặc không được gửi dưới dạng Bearer. Nguyên nhân thường gặp nhất là dán thiếu — sao chép từ một dòng bị xuống dòng thường làm mất phần cuối.

Lưu ý về phiên bản ứng dụng

Màn hình cài đặt của các ứng dụng AI thay đổi khá thường xuyên, vì vậy nếu màn hình không giống như bạn mong đợi, tài liệu MCP của chính ứng dụng sẽ đáng tin cậy hơn. Địa chỉ bạn cần từ chúng tôi vẫn không đổi.