Algolia HTTP 커넥터를 공식 호스팅 MCP 커넥터로 교체

What they did

작성자는 okou-ai/okou 저장소에 범위가 한정된 커넥터 마이그레이션 이슈를 열었으며, 이는 더 큰 HTTP-to-MCP 후보 목록(#36738)의 네이티브 하위 이슈입니다. 작성자는 okou-ai/okou-connectors에서 기존 `algolia` HTTP 커넥터(커밋 b2489d85에 고정)를 확인하고, HTTP와 MCP 카탈로그 항목을 병행 유지하는 대신 `algolia-mcp`로 전면 교체할 것을 제안했습니다. 작성자는 공식 호스팅 엔드포인트(https://mcp.algolia.com/mcp)와 algolia/skills의 퍼스트파티 설정 문서를 찾은 뒤 공개 탐색을 실행했습니다. 새 initialize는 HTTP 401을 반환했고, SDK 탐색으로 정확한 리소스 바인딩, authorization-code 지원 및 PKCE S256을 확인했으며, issuer는 public-client 토큰 인증 `none`을 사용하는 DCR을 광고했습니다(CIMD는 광고되지 않음). 사전 점검에서 일시적인 public DCR 클라이언트 하나를 등록하고 OAuth 거부 없이 Algolia 로그인으로의 302 리다이렉트를 확인했습니다. 또한 마스킹된 프로덕션 전수 조사를 실행하여 `algolia`에 대해 보존된 연결 행이 0개임을 확인했습니다. 이어서 작성자는 기능 차이를 문서화했습니다. 네이티브 Productivity MCP는 사용자 범위이며 읽기 전용이므로 인덱스/레코드 변경, 관련성 설정, API 키 및 관리자 쓰기는 폐기되는 반면, OAuth 액세스는 로그인한 사용자의 애플리케이션 전반에 걸쳐 읽기 노출을 넓힐 수 있습니다. 수용 기준은 컷오버 전 재검증, 기능 변경에 대한 명시적 수용, 집중된 프로듀서 교체, 새로운 OAuth 동의, CI 기반 검증을 포함합니다.

How it went

검토 가능하고 증거에 기반한 마이그레이션 이슈를 작성했습니다. 고정된 출처, 타임스탬프가 기록된 탐색 결과, 명시적인 수용 기준을 포함합니다. 병합된 코드는 없으며, 실제 계정 로그인, 동의, 토큰 교환, 인증된 도구 탐색은 사용자가 면제하여 미검증 상태로 남겨두었습니다. 이 이슈는 리뷰/CI, 병합, 게시, 서빙 카탈로그 검증을 의도적으로 분리합니다.

Worth knowing

공개 검색, DCR 등록, 인증 진입 검사만 수행되었으며, 엔드투엔드 OAuth 및 비즈니스 호출은 검증되지 않았습니다. 연결 제로 집계는 과거 사용 이력이 전혀 없었다는 증거가 아닙니다. browse, settings, synonyms, rules, dictionaries, keys, logs에 대한 읽기 동등성은 확립되지 않았으며, 대체 구현이 쓰기를 제거하는 동시에 읽기 노출을 넓힐 수 있습니다. Algolia Dashboard에서 Generate AI → MCP Servers → Productivity가 활성화되어 있어야 하며, SEARCH/ANALYTICS 권한이 필요합니다. Okou 연결 해제 시 원격 폐기는 검증되지 않았습니다.

Wiring

작업은 okou-ai/okou-connectors(프로듀서)에서 진행되며, 일반 런타임 격차가 있는 경우에는 별도로 okou-ai/okou에 범위가 지정됩니다. 기존 HTTP 디스크립터는 connectors/algolia/connector.yaml에 있으며, 저장소의 기존 MCP 디스크립터/인증/전송 모델을 사용하는 `algolia-mcp` 디스크립터로 대체됩니다. 인증은 https://mcp.algolia.com/mcp에 대해 PKCE S256을 사용하는 builtin Automatic MCP OAuth authorization-code로 구성되며, 표준 호스팅 콜백 https://api.okou.ai/api/connectors/automatic/callback을 사용합니다. CIMD 클라이언트 메타데이터는 https://api.okou.ai/api/oauth/mcp/client-metadata/okou.json에 위치하지만 발급자(issuer)가 이를 광고하지 않습니다. 검색 순서: public initialize(401 예상), SDK resource metadata, DCR 등록(public client, token auth none), Algolia 로그인 리다이렉트로의 resource + PKCE를 포함한 authorization 요청. 검증은 프로듀서 컴파일/검증 및 PR CI(Vitest)를 통해 실행되며, 소비자 수용 테스트는 고정(pinned) 상태로 진행됩니다. 로컬 개발 서버는 사용하지 않습니다.

Try it yourself

이 저장소에서 `algolia` HTTP 커넥터를 공식 호스팅 Algolia MCP 엔드포인트로 마이그레이션합니다. 단계: (1) connectors/algolia/connector.yaml의 기존 디스크립터를 확인하고 현재 프로듀서 커밋을 고정합니다. (2) 공개 initialize 및 SDK 디스커버리로 https://mcp.algolia.com/mcp를 검증합니다: 정확한 리소스 바인딩, authorization-code + PKCE S256, CIMD 광고 여부를 확인합니다. (3) `algolia`에 대해 보존된 연결의 마스킹된 전수 조사를 실행하고 타임스탬프를 기록합니다. (4) 기존 MCP 디스크립터/인증/전송 모델을 사용하여 `algolia-mcp`라는 이름의 대체 MCP 디스크립터를 작성하며, 정규 콜백은 https://api.okou.ai/api/connectors/automatic/callback이고 수동으로 제공되는 API 키는 없습니다. (5) 기능 차이(capability-delta) 섹션을 작성합니다: 폐기되는 쓰기 작업(인덱스/레코드 변경, 관련성 설정, API 키 및 관리자 쓰기)과 사용자 범위 OAuth로 인한 더 넓은 읽기 노출을 나열합니다. (6) HTTP 스킬, 중복 오퍼링, 프록시, 또는 제공자별 런타임 우회를 번들하지 않습니다. (7) 프로듀서 검증/컴파일과 PR CI를 실행하며, 로컬 개발 서버는 시작하지 않습니다. (8) 실제 계정 로그인, 동의, 토큰 교환, 인증된 도구 디스커버리는 통과했다고 주장하지 말고 미검증으로 기록합니다.