wanteddev/ennoia-plugin/ennoia-connect

Ennoia 연결

Ennoia 계정과 작업 대상을 확인해 다음 업무를 바로 시작할 수 있게 한다.

응답 해석과 최종 안내는 공통 응답 규칙을 적용한다.

연결 확인

host에서 보이는 Skill 이름(ennoia-connect), 설치된 Plugin 식별자, 실제 MCP 서버 이름은 서로 다른 값이다. Skill 목록만 있을 때 그 이름을 Plugin ID나 서버 이름의 조회 filter에 넣지 않는다. Plugin/MCP 도구가 안 보이면 host의 전체 Plugin·MCP server inventory에서 실제 식별자를 확인한 뒤 해당 항목의 활성화·연결 상태를 조회한다. host가 이미 정확한 식별자를 제공했다면 그것을 사용하고 불명확하면 미확인으로 남긴다. 설치된 로컬 manifest 이름만으로 현재 host 설치 ID를 추측하지 않는다.

1. 설치된 Ennoia MCP에서 get_current_ennoia_project를 발견해 호출한다. host에 따라 tool prefix가 달라지므로 mcp__ennoia__ 같은 전체 이름을 고정하지 않는다.
2. 인증·scope 확인이 필요하면 get_ennoia_context를 호출한다. 정상 업무에서 이미 확인된 상태를 매 호출마다 중복 조회하지 않는다.
3. 그룹·프로젝트 이름으로 대상을 표시한다. project_context가 실제 호출 대상의 근거다. 사용자가 이미 정확한 대상을 정했다면 다시 허락을 묻지 않는다.
4. 대상을 바꿔야 하면 list_ennoia_projects로 exact code를 찾고 set_current_ennoia_project로 저장한다. 동명 프로젝트는 그룹까지 비교한다. 사용자가 선택하지 않은 auto_selected 값으로 생성·실행·변경을 시작하지 않는다.

specified scope는 해당 호출의 대상이다. 이를 기본 프로젝트가 바뀌었다고 설명하지 않는다. 읽기 목적의 all 결과는 프로젝트별로 구분한다. 프로젝트 권한이 사라지면 다른 프로젝트로 임의 대체하지 않는다.

인증 복구

host의 needs-auth 또는 AUTH_REQUIRED, ENNOIA_REAUTH_REQUIRED, HTTP 401이면 설치된 실제 Ennoia MCP 서버의 host 인증 흐름을 확인한다. host의 Connected 표시는 실제 사용 연결의 인증 오류보다 우선하지 않는다. Tool 자체를 발견하지 못한 상태와 인증 오류는 구분한다. Claude CLI는 /mcp, Codex CLI는 해당 설치 서버의 인증 명령·안내, 앱은 Ennoia 연결 상세의 로그인/재연결을 사용한다. plugin이 부여한 실제 서버 이름을 먼저 확인한다. 수동 등록 서버가 없는 상태에서 codex mcp login ennoia가 반드시 통한다고 가정하지 않는다.

재인증 뒤 get_ennoia_context와 현재 프로젝트를 확인한다. 같은 실패를 반복하면 오류 코드와 host 연결 상태를 보고하고 무한 재시도하지 않는다. 세부 오류 구분은 인증 복구를 읽는다.

새 serverInfo revision을 사용하려면 실제 사용 연결을 새로 initialize한 metadata와 배포 image revision을 대조한다. Plugin 버전·다른 연결의 cached schema만으로 새 backend 기능을 확정하지 않는다. 인증 실패에 남은 이전 project_context는 현재 선택의 증거가 아니다.

사용자가 계정 전환을 요청했을 때만 switch_ennoia_account, 로그아웃을 요청했을 때만 logout_ennoia를 사용한다. 단순 조회 실패를 해결하려고 기존 연결을 삭제하지 않는다.

완료 기준

인증 성공, 선택된 그룹·프로젝트, 가능한 다음 작업을 간결하게 표시한다. OAuth가 끝나지 않았다면 연결 완료라고 보고하지 않는다. 토큰·cookie·API key를 사용자에게 복사해 달라고 하거나 파일에 저장하지 않는다.