airfocus MCP 서버를 사용하여 airfocus 를 AI 도구와 통합합니다.

airfocus MCP 서버 설정

airfocus MCP 서버는 아래 나열된 클라이언트를 포함한 모든 MCP 클라이언트와 호환됩니다. 설정 프로세스는 사용하는 클라이언트에 따라 다르지만 airfocus MCP를 설정하는 데 필요한 서버 URL은 동일합니다:

• https://mcp.airfocus.app/mcp
  • 이 URL은 브라우저에서 방문하도록 되어 있지 않습니다. AI 도구를 airfocus 의 MCP 서버에 연결할 때 사용하는 매개 변수입니다.

airfocus 의 MCP 서버에 연결하는 단계는 AI 도구마다 다를 수 있습니다. 아래 링크된 호환 가능한 다음 AI 도구에서 제공하는 설명서를 참조하세요:

• ChatGPT
• 클로드 데스크톱
• 클로드 웹
• 마이크로소프트 코파일럿 스튜디오
• GitHub Copilot
• 커서
• Claude Code
• 윈드서핑

이 목록은 지원되는 클라이언트의 전체 목록이 아니며 airfocus MCP 서버는 모든 MCP 클라이언트에 연결할 수 있습니다.

저희는 헬프 센터의 정보를 최신 상태로 유지하기 위해 최선을 다하고 있습니다. 그러나 이 섹션에 링크된 타사 리소스는 airfocus 소유가 아니며 예고 없이 변경될 수 있습니다. 이 정보가 오래되었다고 생각되면 여기로 알려주세요.

JSON 구성 요구 사항

일부 AI 도구는 MCP 서버에 연결하기 위해 JSON 구성 파일을 수동으로 편집해야 할 수 있습니다.

AI 도구가 HTTP 전송 방법을 지원하는 경우 이 JSON 구성을 사용하세요:

"airfocus": {
"type": "http",
"url": "https://mcp.airfocus.app/mcp"
}

AI 도구가 HTTP 전송 방법을 지원하지 않는 경우, 로컬 서버를 실행하여 airfocus 의 MCP 서버로 HTTP 요청을 전달해야 합니다. 이 작업은 mcp-remote Node.js 패키지를 사용하여 수행할 수 있습니다. 컴퓨터에 Node.js가 설치되어 있는지 확인한 다음 다음 JSON 구성을 사용합니다:

"airfocus": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.airfocus.app/mcp"]
}

airfocus MCP 서버에서 사용 가능한 작업

airfocus MCP 서버가 설정되면 이를 사용하여 AI 도구에 프롬프트를 입력하여 airfocus 에서 다양한 작업을 완료할 수 있습니다. airfocus MCP 서버에 더 많은 사용 사례를 추가함에 따라 새로운 기능이 작동하려면 AI 도구로 다시 인증해야 할 수도 있습니다.

현재 지원되는 사용 사례는 다음과 같습니다:

• 특정 콘텐츠를 보려면 airfocus 항목을 검색하세요.
  • 예시: "예: 온보딩 재설계와 관련된 airfocus 의 모든 항목을 표시합니다."
• 항목 세부 정보 및 콘텐츠를 검색하고 요약합니다.
  • 예시: "예: airfocus 에서 '3분기 로드맵 검토' 항목을 찾아 진행 중인 내용을 요약해 주세요."
• 작업 공간, 상태, 담당자 또는 기타 필드별로 항목을 필터링하고 찾아 보세요.
  • 예시: "예: 이니셔티브 작업 영역에서 현재 '진행 중' 상태인 내게 할당된 모든 항목을 표시합니다."
• 특정 항목과 연결된 고객 인사이트를 확보하세요.
  • 예시: "예: airfocus 에서 '필수 필드' 기회에 연결된 고객 피드백은 무엇인가요?"
• 제목, 설명 및 선택적 필드를 사용하여 작업 공간에 새 항목을 만듭니다.
  • 예시: "내 로드맵 작업 영역에 '온보딩 흐름 개선'이라는 새 항목을 만들고 상태를 '후보'로 설정합니다."
• 기존 airfocus 항목에 댓글을 추가합니다.
  • 예시: "'필수 필드' 항목에 '다음 분기에 이 항목의 범위를 정할 계획이며 예상치가 나오면 업데이트할 예정입니다'라는 댓글을 추가합니다."
• 고객 피드백을 통해 인사이트를 창출하세요.
  • 예시: "'SSO 차단 채택' 피드백 항목에서 인사이트를 만들어 'SSO 지원' 기회에 연결합니다."
• 작업 공간의 기존 항목을 업데이트합니다.
  • 예시: "이 항목을 John에게 할당하고 상태를 "활성"으로 업데이트합니다. 분기 필드를 2027년 4분기로 설정합니다."

관리자용: 팀에 대한 MCP 서버 사용 활성화 또는 비활성화

기업 계정의 관리자는 팀 내 사용자에게 airfocus MCP 서버에 대한 액세스 권한을 부여할지 여부를 제어할 수 있습니다.

팀의 airfocus MCP 서버에 대한 액세스를 제한하거나 허용합니다:

1. airfocus 의 왼쪽 하단 모서리에 있는 이름을 클릭합니다.
2. 팀 설정을 선택합니다.
3. 패널 상단의 기능 탭을 선택합니다.
4. "airfocus MCP" 에서 'airfocus MCP 사용' 옆의 토글을 사용합니다.
5. 표시되는 모달에서 MCP 액세스 활성화 또는 MCP 액세스 비활성화를 클릭합니다.

자주 묻는 질문(FAQ)

airfocus MCP 서버는 어떻게 작동하나요?
airfocus MCP 서버는 https://mcp.airfocus.app/mcp에서 사용할 수 있는 원격 서비스입니다. 스트리밍 가능한 HTTP 전송 프로토콜과 동적 클라이언트 등록(DCR)을 사용하여 클라이언트 액세스를 안전하게 관리합니다. 인증은 OAuth 2.0을 통해 처리되며, airfocus 사용자는 MCP 서버가 자신의 AI 도구와 통합되도록 인증할 수 있습니다. 설정하는 동안 사용자는 두 가지 인증 단계를 완료합니다:

• 서버 인증: airfocus MCP 서버를 인증하고 신뢰할 수 있는 서비스로 등록합니다.
• 권한 범위 승인: MCP 서버에 airfocus 내의 항목, 워크스페이스 및 인사이트에 대한 액세스 권한을 부여합니다.

airfocus MCP 서버가 팀의 데이터와 상호 작용하려면 인증과 범위 승인이 모두 필요합니다.

airfocus MCP 서버는 어떤 정보에 액세스할 수 있나요?
airfocus MCP 서버는 항목 제목, 설명, 필드 값, 상태 및 연결된 인사이트를 포함하여 airfocus 팀 내에서 액세스할 수 있는 권한이 있는 모든 항목, 워크스페이스 및 인사이트에 액세스할 수 있습니다. 다른 airfocus 팀에 속한 데이터에는 액세스할 수 없습니다.

airfocus MCP 서버에서 내 데이터는 어떻게 사용되나요?
airfocus MCP 서버는 패스스루 역할을 하며 아이템 콘텐츠, 사용자 프롬프트 또는 쿼리를 보관하지 않습니다. 인증 정보는 airfocus 팀 외부로 절대 공유되지 않습니다. airfocus MCP 서버의 사용은 airfocus 의 표준 서비스 약관의 적용을 받습니다.

airfocus MCP는 Jira 또는 Azure DevOps와 같은 통합과 동기화된 데이터와 어떻게 상호 작용하나요?
airfocus 내의 항목에 대한 편집 내용은 워크스페이스 내 통합의 구성에 따라 타사 통합과 동기화될 수 있습니다. airfocus 내에서 사용자가 직접 편집한 내용이 타사에 자동으로 동기화되는 경우, 사용자가 MCP 서버를 통해 편집한 내용도 동일한 동기화 동작이 발생합니다. MCP 서버를 활성화하기 전에 airfocus 에서 통합 구성을 검토하는 것이 좋습니다.

리소스

이 기능에 관한 더 자세한 정보는 아래의 추가 자료에서 살펴볼 수 있습니다. 리소스는 영어로만 제공됩니다.

외부 리소스
MCP 서버에 대해 자세히 알아보려면 이 외부 문서를 확인하세요:

• 모델 컨텍스트 프로토콜(MCP)이란 무엇인가요?

이 문서에 관한 피드백 공유