MCP를 통한 AI 어시스턴트 연결

AB Projects는 Model Context Protocol (MCP) 서버를 제공하므로 AI 어시스턴트 — Claude, ChatGPT, Cursor, Windsurf, Codex CLI, Antigravity 및 사양을 준수하는 모든 MCP 클라이언트 — 가 사용자를 대신하여 작업, 프로젝트, 문서를 읽고 관리할 수 있습니다. 이 문서에서는 각 클라이언트를 연결하는 방법을 안내합니다.

시작하기 전에 필요한 것

기존 AB Projects 계정. 계정이 없다면 먼저 Microsoft Teams를 통해 설정하십시오(AB Projects Teams 앱 설치 참조).
MCP 서버 URL: https://mcp.actionbridge.io/mcp
로그인에 사용할 Microsoft 365 계정 또는 AB Projects 이메일과 비밀번호.

중요: URL은 https://mcp.actionbridge.io/mcp — /mcp 경로를 포함해야 합니다. 호스트만 입력한 경우(https://mcp.actionbridge.io)는 유효한 MCP 엔드포인트가 아니며, 이를 입력하면 서버에는 도달했더라도 클라이언트가 인증 실패를 보고합니다.

Claude Desktop 연결

Claude Desktop → Settings → Connectors를 엽니다.
Add Custom Connector를 클릭합니다.
다음을 입력합니다:
- Name: AB Projects
- URL: https://mcp.actionbridge.io/mcp
Connect를 클릭합니다. 로그인을 요청하는 브라우저 창이 열립니다.
Sign in with Microsoft를 선택하거나 AB Projects 이메일과 비밀번호를 입력합니다.
로그인하면 Claude Desktop이 자동으로 등록되고 AB Projects MCP 도구 목록을 표시합니다.

Claude Cowork 연결

Cowork에서 MCP 구성을 열고 다음을 추가합니다:

URL:  https://mcp.actionbridge.io/mcp
Auth: OAuth (automatic)

Cowork는 처음 연결할 때 Claude Desktop과 동일한 OAuth 로그인을 사용하여 브라우저 창을 엽니다.

ChatGPT 연결

ChatGPT 사용자 지정 커넥터는 Plus, Pro, Business 또는 Enterprise 구독이 필요합니다.

ChatGPT → Settings → Connectors → Add custom connector를 엽니다.
다음을 입력합니다:
- Name: AB Projects
- MCP Server URL: https://mcp.actionbridge.io/mcp (/mcp 경로가 포함되었는지 확인하십시오)
Connect를 클릭합니다. 브라우저 창이 열립니다.
Microsoft로 로그인하거나 AB Projects 이메일과 비밀번호로 로그인합니다.
승인 후 ChatGPT는 AB Projects가 연결됨으로 표시된 커넥터 목록으로 돌아갑니다.

Cursor, Codex CLI, Windsurf, Antigravity 연결

이러한 편집기는 MCP 서버에 대해 JSON 구성 파일을 사용합니다. 다음 항목을 추가하십시오(주변 구성 형식은 도구마다 다르지만 서버 블록은 동일합니다):

{
  "mcpServers": {
    "actionbridge": {
      "url": "https://mcp.actionbridge.io/mcp"
    }
  }
}

편집기가 처음 연결할 때 로그인할 수 있도록 브라우저 창이 열립니다. 클라이언트 ID나 시크릿은 필요하지 않습니다 — 인증은 OAuth로 처리됩니다.

MCP 액세스 관리

클라이언트를 연결하면 AB Projects가 백그라운드에서 사용자 계정으로 범위가 지정된 API 키를 자동으로 발급하므로, 어시스턴트는 사용자로서만 그리고 사용자가 멤버인 프로젝트에 대해서만 작동합니다.

클라이언트 연결을 해제하려면: 해당 AI 클라이언트에서 AB Projects 커넥터를 제거하십시오(예: Claude/ChatGPT에서 사용자 지정 커넥터를 삭제하거나, 편집기 구성에서 서버 블록을 제거). 다음에 다시 추가할 때 다시 로그인해야 합니다.
서버 측 액세스를 취소하려면(예: 기기를 분실한 경우) support@actionbridge.io로 문의하십시오 — 셀프 서비스 키 관리 화면은 아직 제공되지 않습니다.
어시스턴트가 변경한 모든 사항은 항목의 변경 기록에 기록되고 명확한 AI 공개와 함께 연결된 Teams 채널에 게시되므로 MCP 활동은 항상 감사할 수 있습니다(MCP 도구 참조 참조).

문제 해결

“MCP 서버에 연결할 수 없음”

거의 항상 잘못된 URL이 원인입니다. 다음을 확인하십시오:

호스트만이 아니라 https://mcp.actionbridge.io/mcp를 사용했는지.
http://가 아니라 https://를 입력했는지.
끝에 슬래시, 공백 또는 추가 문자가 없는지.

“MCP 서버 인증 실패”

URL에 /mcp가 포함되어 있는지 다시 확인하십시오. 호스트만 가리키면 OAuth는 성공하지만 첫 번째 도구 호출이 상태 확인 응답을 반환하고 클라이언트가 “인증 실패”를 보고합니다.
Microsoft로 로그인한 경우, 해당 Microsoft 이메일이 기존 AB Projects 계정과 일치하는지 확인하십시오. 신규 사용자는 먼저 Microsoft Teams를 통해 설정해야 합니다.
문제가 지속되면 AI 클라이언트에서 커넥터를 제거했다가 다시 추가하여 새 로그인을 시작하십시오.

클라이언트는 연결되지만 도구가 표시되지 않음

클라이언트의 도구 목록을 새로 고치십시오. 여전히 비어 있으면 커넥터를 제거했다가 다시 추가하십시오 — 첫 번째 initialize 호출이 토큰 교환과 경합했을 수 있습니다.

여전히 해결되지 않나요?

support@actionbridge.io로 문의하십시오. AI 클라이언트에 참조 코드가 표시되면 — 예를 들어 ChatGPT의 ofid_... 또는 모든 요청 ID — 함께 알려 주십시오. 이를 통해 팀이 서버 로그에서 정확한 세션을 찾을 수 있습니다.

MCP를 통한 AI 어시스턴트 연결