프로그래밍 방식 접근과 자동화

개요

인터페이스 없이 Whisperer를 쓰는 방법은 세 가지입니다. AI 클라이언트를 위한 MCP 서버, 반복 자동화를 위한 연결 서비스, 그리고 자료를 다른 곳으로 옮기는 내보내기입니다. Whisperer는 범용 공개 REST API를 제공하지 않습니다. /v1/ 아래 주소는 자사 앱과 백엔드 사이의 비공개 통로이며, 호환성을 약속하지 않고 언제든 바뀔 수 있습니다.

이는 누락이 아니라 의도한 경계입니다. 공개한 API는 몇 년 동안 계속 동작해야 합니다. MCP는 같은 접근을 제공하면서 버전 관리, 동의 화면, 권한 해지를 이미 갖추고 있습니다.

언제 사용하나요

  • AI 어시스턴트가 회의를 읽고 작업을 다루게 하고 싶다 → MCP.
  • 반복 동작이 필요하다(「새 회의 → 시트에 한 줄」) → Zapier.
  • 자료 자체를 다른 도구에서 쓰고 싶다 → 내보내기.

단계별 안내

  1. AI 클라이언트는 MCP로 연결합니다: MCP: Claude, ChatGPT, Cursor 연결하기. 이것이 지원되는 프로그래밍 경로이며 안정성을 약속하는 유일한 경로입니다.
  2. 자동화는 계정에서 Zapier, Notion, Slack, HubSpot을 연결한 뒤 시나리오를 그 서비스에서 만듭니다.
  3. 일회성 이전은 회의 페이지에서 Markdown, SRT, VTT, JSON으로 내보냅니다.
  4. 기계가 읽을 수 있는 제품 정보가 필요하면 — 예를 들어 AI 어시스턴트가 Whisperer 자체에 대한 질문에 답하게 하려면 — https://whisperer.one/llms.txt 또는 전체 모음 https://whisperer.one/llms-full.txt를 알려 주세요. 둘 다 공개되어 있고 인증이 필요 없습니다.

공개된 것

주소 무엇인가
https://whisperer.one/mcp 외부 AI 클라이언트를 위한 MCP 서버
https://whisperer.one/.well-known/oauth-protected-resource 클라이언트가 인증 방법을 알아내는 곳
https://whisperer.one/.well-known/oauth-authorization-server OAuth 엔드포인트와 지원 범위
https://whisperer.one/llms.txt AI 시스템을 위한 제품 색인
https://whisperer.one/llms-full.txt 공개 문서 전체를 한 파일로
https://whisperer.one/docs/en/<페이지>.md 영어 문서의 모든 페이지를 순수 Markdown으로

자주 하는 실수

  • /v1/ 위에 만들기. 이 주소는 내부용입니다. 크롤러에 닫혀 있고, 운영 환경에서 스키마가 꺼져 있으며, 예고 없이 바뀝니다.
  • API 키 찾기. 공개 REST API가 없으므로 존재하지 않습니다. 외부 접근은 MCP 동의 절차로 발급되는 bearer 토큰입니다.
  • 웹훅 기대하기. 나가는 자동화는 Zapier와 연결 서비스를 통하며, 자체 웹훅은 없습니다.

모범 사례

  • OAuth 엔드포인트는 코드에 박아 넣지 말고 메타데이터 문서에서 읽으세요. 클라이언트를 깨지 않고 옮길 수 있도록 그곳에 공개해 둔 것입니다.
  • 통합마다 별도의 연결을 만들어, 하나를 해지해도 나머지가 영향을 받지 않게 하세요.

관련 문서