MentionBird

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

대부분의 AI 앱은 로그인 방식으로 MentionBird에 연결합니다. 앱에 주소 하나를 입력하고 MentionBird 로그인 정보로 로그인한 다음 워크스페이스를 선택하면 됩니다. 만들거나 붙여 넣을 키는 없습니다. Claude, Claude Code, Codex는 이 방식으로 연결됩니다.

주소는 모두 동일합니다.

https://mcp.mentionbird.ai/mcp

MentionBird에서는 워크스페이스 이름이 미리 입력된 동일한 단계를 제공합니다. 사이드바에서 MCP를 클릭하고 Connect an AI app 탭을 여세요. ChatGPT에 대해서는 별도의 문서가 있습니다. Connecting MentionBird to ChatGPT를 참조하세요.

처음 연결하면 브라우저에서 MentionBird 로그인 페이지가 열립니다. 로그인한 다음:

1. 워크스페이스를 선택합니다. 연결은 해당 워크스페이스만 읽으며 다른 항목은 읽지 않습니다. 요금제에 MCP 액세스가 포함되지 않은 워크스페이스는 회색으로 표시됩니다.
2. Allow changes를 선택할지 결정합니다. 선택하면 앱이 브랜드와 프롬프트를 추가할 수 있습니다. 선택하지 않으면 읽기만 가능합니다. 어느 쪽이든 앱은 항목을 수정하거나 삭제할 수 없습니다.
3. Allow를 클릭합니다.

앱으로 돌아가면 이후에는 로그인 상태가 유지되고 백그라운드에서 액세스 권한이 갱신됩니다.

Claude

Claude 웹, 데스크톱 앱, Cowork에서 사용할 수 있습니다.

1. Settings → Connectors를 열고 Add custom connector를 클릭합니다.
2. 이름을 MentionBird로 지정합니다. 두 개 이상의 워크스페이스를 연결할 예정이라면 워크스페이스 이름도 추가하세요. 그런 다음 위 주소를 붙여 넣습니다. Claude가 감지한 로그인 옵션은 그대로 두세요.

Claude Team 또는 Enterprise 요금제를 사용하는 경우, 먼저 소유자가 Organization settings → Connectors에서 커넥터를 추가해야 합니다. 그런 다음 각 구성원이 커넥터에서 Connect를 클릭하고 자신의 MentionBird 로그인 정보로 로그인합니다.

Claude Code

다음 두 명령을 실행합니다.

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

Connect an AI app 탭에는 워크스페이스 이름이 포함된 동일한 명령이 표시됩니다. 두 개 이상의 워크스페이스를 연결할 예정이라면 해당 탭에서 복사하세요. 나중에 Claude Code에서 MentionBird 인증이 필요하다는 메시지가 표시되면 /mcp을 실행하고 MentionBird 항목을 선택한 다음 Authenticate를 선택하세요.

Codex

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

Codex에서 MentionBird 도구를 사용할 수 없다고 표시되면 codex mcp login mentionbird을 실행해 다시 로그인하세요.

나중에 앱에서 변경할 수 있도록 허용하기

Allow changes를 선택하지 않았다면 필요할 때 언제든지 허용할 수 있습니다.

• Claude 및 Claude Code는 항목을 추가해야 할 때 처음으로 다시 로그인하라는 메시지를 표시합니다. 그때 선택하세요.
• Codex는 로그인할 때 선택한 액세스 권한을 유지합니다. codex mcp login mentionbird을 다시 실행하고 선택하세요. 그래도 Codex가 다음 변경을 거부하면 다시 요청하세요.

두 개 이상의 워크스페이스 연결하기

각 연결은 하나의 워크스페이스만 읽습니다. 다른 워크스페이스를 연결하려면 MentionBird에서 해당 워크스페이스로 전환한 다음, 그 워크스페이스의 Connect an AI app 탭에서 안내를 따르세요. 탭에 표시되는 이름도 해당 워크스페이스에 맞게 지정되어 있습니다. 각 항목을 워크스페이스 이름에 따라 mentionbird-acme, mentionbird-globex처럼 지정하면 사용자와 어시스턴트가 구분하기 쉽습니다.

Claude는 주소마다 커넥터 하나만 유지하므로 Claude에서 두 번째 워크스페이스를 연결하려면 주소 끝에 워크스페이스를 추가하세요. 예: https://mcp.mentionbird.ai/mcp?workspace=globex. Connect an AI app 탭에서 각 워크스페이스의 정확한 주소를 확인할 수 있습니다.

API 키로 이미 연결했나요?

새 연결을 추가하기 전에 기존 항목을 삭제하세요. 그렇지 않으면 MentionBird 도구가 두 번 표시됩니다. Claude Code에서는 claude mcp remove mentionbird, Codex에서는 codex mcp remove mentionbird를 실행하세요. 또는 지정한 이름을 사용하면 됩니다. 그런 다음 다른 곳에서 사용하지 않는 키라면 Manage access 탭에서 폐기하세요.

Cursor 및 기타 클라이언트

Cursor와 위에 나열되지 않은 다른 MCP 클라이언트는 API 키로 연결합니다. 주소는 동일하며 키를 bearer token으로 전송합니다.

Cursor에서 프로젝트에 .cursor/mcp.json을 만들거나, 모든 곳에서 사용하려면 ~/.cursor/mcp.json를 만들고 다음 내용을 넣으세요.

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

YOUR_API_KEY을 키로 바꾸고 Cursor를 다시 시작한 다음 Settings → MCP에서 초록색 상태 점을 확인하세요.

구성 파일을 읽는 클라이언트에는 동일한 두 값이 필요합니다. 주소와 키를 담은 Authorization: Bearer 헤더입니다. 키는 데이터에 접근할 수 있는 비밀번호이므로 해당 파일을 저장소나 스크린샷에 포함하지 마세요.

Claude도 키로 연결할 수 있으며, Connect an AI app 탭에서 해당 단계를 확인할 수 있습니다. 다만 로그인 방식이 더 간단하고 구성 파일에 비밀 정보를 저장하지 않아도 됩니다.

연결 확인하기

계정에만 해당하는 질문을 해 보세요. *"내가 추적 중인 브랜드는 뭐야?"*가 가장 간단한 테스트입니다.

연결되지 않는 경우

다음 순서대로 확인하세요.

1. 워크스페이스를 확인합니다. 로그인 화면에서 회색으로 표시되었다면 해당 요금제에는 MCP 액세스가 포함되지 않습니다. 어떤 요금제에서 사용할 수 있는지는 pricing page에서 확인하세요.
2. 다시 로그인합니다. Claude에서는 커넥터에서 Connect를 클릭합니다. Claude Code에서는 /mcp을 실행한 다음 Authenticate를 선택합니다. Codex에서는 codex mcp login를 실행합니다.
3. 연결이 해제되지 않았는지 확인합니다. 누군가 연결을 해제했거나, 워크스페이스에서 제거되었거나, 오랫동안 사용하지 않으면 연결이 종료됩니다. 다시 로그인하면 새 연결이 시작됩니다. Seeing and disconnecting connected apps를 참조하세요.
4. 앱을 다시 시작합니다. 대부분의 앱은 시작할 때 커넥터 목록을 읽습니다.

API 키를 사용하는 경우 인증 오류는 키가 불완전하거나 폐기되었거나 Bearer으로 전송되지 않았다는 뜻입니다. 가장 흔한 원인은 붙여 넣은 키가 잘린 경우입니다. 줄바꿈된 줄에서 복사하면 끝부분이 누락되는 경우가 많습니다.

앱 버전에 대한 참고 사항

AI 앱의 설정 화면은 자주 바뀌므로 화면이 예상과 다르게 보이면 해당 앱의 MCP 문서를 참고하는 것이 더 정확합니다. 저희가 제공하는 주소는 계속 동일합니다.