어댑터 연결
허용할 접근 권한을 가진 API 토큰으로 MCP 어댑터가 Semaphore 인스턴스를 가리키게 하세요.
아직 자동화를 수동으로 설정하시나요?
어시스턴트는 스크립트를 도와줍니다. 하지만 템플릿 생성, 입력 설정, 작업 예약에는 여전히 인터페이스 전환과 맥락 반복이 필요합니다.
같은 대화에서 Semaphore 사용
MCP로 AI 클라이언트에서 Semaphore를 설정하고 작업을 시작하며 결과를 살펴보세요. 설정된 API ID가 접근 가능한 리소스와 동작을 결정합니다.
자동화 설정프로젝트, 템플릿, 입력, 예약 관리
작업 실행Semaphore에서 작업 시작 또는 중지
결과 조사작업 출력 및 프로젝트 활동 읽기
Semaphore를 Claude Code에 연결
한 번 연결하면 Claude Code에서 Semaphore를 사용할 수 있습니다. MCP 어댑터가 Semaphore API 호출 도구를 클라이언트에 제공합니다.
Claude Code에 추가
MCP 클라이언트에 어댑터를 등록하세요. 사용 가능한 도구가 Claude Code에 나타납니다.
자동화 작업하기
활성화한 도구와 권한으로 템플릿 생성, 입력 업데이트, 작업 예약, 실행 조사를 수행하세요.
실패한 실행에 사용해 보기
“프로젝트에서 가장 최근에 실패한 작업을 찾아 출력을 읽고 다음에 확인할 내용을 제안하세요. 아무것도 변경하지 마세요.”
조사를 자동화와 연결 유지
원본 작업 증거 확인
실행 기록 및 로그
연동에서 사용할 ID 선택
접근 제어어댑터와 클라이언트가 접근할 수 있는 것
실패한 실행에 대해 더 정확하게 질문하기
어시스턴트는 어댑터가 공개하는 주변 템플릿 및 프로젝트 정보와 작업 출력을 연결하도록 도울 수 있습니다. 작업을 지정하고, 증거가 뒷받침하는 내용을 물으며, 진단과 변경 제안을 구분하면 유용합니다. 도구 지원 범위는 어댑터 버전에 따라 다르므로 필요한 읽기 동작을 실제로 사용할 수 있는지 확인하세요.
어시스턴트가 사용하는 권한의 주체 파악
문서화된 MCP 어댑터에서 설정된 SEMAPHORE_API_TOKEN은 항상 클라이언트가 제공한 토큰보다 우선합니다. 전역 토큰이 없으면 HTTP 요청은 각 클라이언트의 Bearer 토큰을 전달할 수 있습니다. 공유 토큰은 권한과 API ID를 공유한다는 의미이며, 어시스턴트를 쓰는 개별 사람을 신뢰할 수 있게 식별하지는 못합니다.
변경의 경계를 명확히 유지
어댑터에는 읽기뿐 아니라 변경 도구도 포함됩니다. 채팅에서 시작했어도 작업 실행이나 템플릿 변경은 운영 작업입니다. 사람의 확인은 클라이언트와 워크플로 설계의 선택이며 MCP 자체가 강제하지는 않습니다. 위험이 낮은 조사로 시작하고 동작을 테스트한 뒤 허용 범위를 넓히세요.
작업 맥락의 전송 범위 결정
Semaphore 셀프 호스팅은 서비스 실행 위치를 제어합니다. 어시스턴트 클라이언트가 반환된 로그나 메타데이터를 모델 프로바이더로 보내는 것을 막지는 않습니다. 연결을 활성화하기 전에 클라이언트와 모델 배포를 검토하고 비밀이 포함된 출력을 피하며 어떤 맥락이 네트워크 밖으로 나갈 수 있는지 결정하세요.
문서 및 관련 기능
FAQ
MCP 연동은 Semaphore 내장 AI 어시스턴트인가요?
여기서 설명하는 설정은 Semaphore REST API와 통신하는 별도 MCP 어댑터를 사용합니다. 내장된 공식 어시스턴트가 아닙니다. 어댑터는 지원 동작을 호환 클라이언트에 공개하고 클라이언트와 모델이 대화 경험을 제공합니다. 기능과 유지보수는 Semaphore 릴리스와 별개로 바뀔 수 있으므로 연결 전에 도구 목록, 인증, 배포 모델을 검토하세요.
어시스턴트는 누구의 권한을 사용하나요?
어댑터가 실제 선택한 API 토큰의 ID를 사용합니다. 문서화된 어댑터 구현에서는 설정된 전역 SEMAPHORE_API_TOKEN이 클라이언트 토큰보다 우선합니다. 전역 토큰 없는 HTTP 모드는 클라이언트별 Bearer 토큰을 전달할 수 있습니다. 따라서 공유 토큰은 권한과 API ID를 공유한다는 뜻이며 어시스턴트와 대화하는 각 사람의 확실한 식별을 의미하지는 않습니다. 여러 사용자를 추가하기 전에 배포 모드를 의도적으로 선택하세요.
읽기 전용 작업 조사부터 시작할 수 있나요?
네. 다만 Semaphore ID와 검증된 어댑터 및 클라이언트 설정으로 의도한 경계를 강제하세요. 변경을 피하라는 채팅 지시는 기반 토큰 권한 제한을 대체하지 않습니다. 구체적인 작업과 맥락 및 출력 검색에 필요한 읽기 동작부터 시작하세요. 운영 동작으로 연동을 확장하기 전에 어시스턴트 설명이 반환된 증거를 따르는지 확인하세요.
작업 로그가 외부 모델 프로바이더에 전송될 수 있나요?
네. 어시스턴트 클라이언트와 모델 배포에 따라 달라집니다. Semaphore 셀프 호스팅은 앱이 실행되는 위치를 정하지만 연결된 클라이언트가 반환된 맥락을 다른 곳으로 전달하는 것을 막지는 않습니다. 로그, 메타데이터, 어댑터 호스팅, 모델 처리를 포함한 전체 데이터 경로를 검토하세요. 작업 출력에 민감한 값이 들어갈 수 있으므로 연결 전에 노출 범위를 결정하고 적절한 자격 증명과 프로젝트 접근을 선택하세요.
실패한 Ansible 작업에 대해 어시스턴트에게 무엇을 물을 수 있나요?
작업 식별자에서 시작해 어댑터의 지원 도구로 상태와 출력을 읽도록 어시스턴트에 요청하세요. 반환된 증거로 실패 단계를 설명하고 점검을 제안할 수 있습니다. 특히 플레이북, 자격 증명, 대상 인프라를 바꾸기 전에 제안을 원본 작업 로그와 대조하세요.
MCP가 Semaphore UI나 REST API를 대체하나요?
아니요. MCP 어댑터는 Semaphore REST API로 지원되는 작업을 호환 어시스턴트 클라이언트에 노출합니다. 실제 작업 실행과 결과 기록은 계속 Semaphore가 담당합니다. 웹 UI에서 원본 작업을 열면 대화나 모델 설명과 무관하게 출력을 확인할 수 있습니다.
어댑터로 기존 Semaphore 프로젝트를 사용할 수 있나요?
네. 설정된 API ID가 프로젝트에 접근할 수 있고 어댑터가 필요한 동작을 지원한다면 가능합니다. 알려진 작업부터 시작해 읽기 도구가 반환한 정보를 확인하세요. 연동으로 기존 실행 기록을 확인하기 위해 플레이북이나 스크립트를 다시 쓸 필요는 없습니다.
어시스턴트가 실패한 작업을 자동 복구하거나 재실행하나요?
작업 조사 자체가 자동화를 다시 실행하거나 복구하지는 않습니다. 어댑터가 변경 도구를 노출할 수 있으므로 사용 가능한 동작은 버전, 클라이언트 설정, API 권한에 따라 달라집니다. 기반 ID의 권한으로 의도한 읽기 전용 접근을 강제하고, 실행 동작을 허용하기 전에 정확한 프로젝트와 작업을 검토하세요.