teasa테사 열기

AI 컴패니언 MCP 서버

빛나는 유리 노드들의 조형적 네트워크 옆에 선 소프트웨어 엔지니어

공개 카탈로그로 이어지는 깨끗한 연결 — 비공개 데이터는 아무것도 새어 나가지 않습니다.

당신의 에이전트에게 테사(Teasa) 카탈로그를 들여다볼 창을 열어 주세요. 테사 MCP 서버는 오픈 소스 Model Context Protocol 서버로, Claude Desktop, Claude Code를 비롯한 모든 MCP 지원 클라이언트가 공개 AI 컴패니언 — 크리에이터들이 테사에 출판한 인터랙티브 캐릭터와 스토리 — 을 검색하고 둘러볼 수 있게 해 줍니다.

이 서버는 의도적으로 작고, 의도적으로 심심하고, 의도적으로 안전합니다. 읽기 전용 툴 세 개, 공개 데이터만, 자격 증명 없음, 쓰기 권한 없음. 그것이 핵심입니다.

무엇을 만들 수 있는가

어시스턴트를 테사 카탈로그에 연결하면 이런 일이 가능해집니다.

추천 봇, 카탈로그 대시보드, AI 컴패니언 분야 리서치, 아니면 그저 매일 쓰는 어시스턴트가 "오늘 밤엔 뭘 읽을까?"에 답하게 하는 것까지 — 스크레이핑 없이 공개 컴패니언 카탈로그에 구조화된 접근이 필요한 어떤 것이든 가능합니다.

빠른 시작

Node 20 이상이 필요합니다. npx로 실행하세요.

npx @teasa/mcp-server

또는 MCP 클라이언트 설정에 등록하세요.

{
  "mcpServers": {
    "teasa": {
      "command": "npx",
      "args": ["-y", "@teasa/mcp-server"]
    }
  }
}

서버는 stdio로 MCP를 통신하며 설정이 전혀 필요 없습니다. 선택적 환경 변수 TEASA_API_URL 하나로 로컬 개발용 다른 API 인스턴스를 가리킬 수 있습니다.

툴 레퍼런스

툴 입력 출력
search_companions query, 선택적 genre, 선택적 maxContentLevel, 선택적 limit 순위가 매겨진 공개 컴패니언 카드와 페이지네이션 커서
get_companion slug 공개 컴패니언 카드 하나, 또는 null
get_creator handle 크리에이터 공개 프로필과 그의 공개 컴패니언 카드

부드럽게 빛나는 세 갈래 길을 잇는 투명한 접점 주위에서 맞잡는 두 손

세 개의 의도된 경로, 하나의 통제된 접점, 숨겨진 접근은 없음.

처음부터 읽기 전용으로 설계

대부분의 MCP 서버는 API 키와 쓰기 권한을 믿고 맡기라고 요구합니다. 이 서버는 믿고 맡길 것 자체가 없도록 설계되었습니다.

이것은 테사의 웹·모바일 앱이 기반으로 삼는 공개 DTO 허용 목록 원칙을 에이전트 생태계에 그대로 적용한 것입니다.

오픈 소스

서버는 콤팩트한 TypeScript 패키지로 배포됩니다. stdio 진입점 하나, 툴 핸들러와 허용 목록 스키마를 담은 서버 모듈 하나, 그리고 단위 테스트가 갖춰진 HTTP 계층(테스트는 모의 응답으로 완전히 오프라인에서 실행됩니다). 10분이면 읽고, 20분이면 감사할 수 있습니다. 이슈와 풀 리퀘스트를 환영합니다 — 컴패니언 탐색 위에 에이전트 경험을 만들고 있고 또 다른 읽기 전용 표면이 필요하다면(공개 로어북이 다음 후보입니다), 이슈를 열고 이야기해 주세요.

FAQ

테사 계정이 필요한가요? 아니요. 공개 데이터만 다루므로 로그인할 것 자체가 없습니다.

컴패니언에게 메시지를 보내거나 내 채팅을 읽을 수 있나요? 아니요. 채팅, 기억, 계정 데이터는 어떤 툴로도 노출되지 않으며, 서버는 거기에 닿을 수 있는 자격 증명을 아예 갖고 있지 않습니다.

어떤 클라이언트와 함께 작동하나요? stdio 서버를 지원하는 모든 MCP 클라이언트 — Claude Desktop, Claude Code, 그리고 계속 늘어나는 MCP 지원 에이전트·IDE 생태계.

이어서 읽기

AI 캐릭터 카드 작성법 (예시 포함)
AI 롤플레이 용어 사전: 쉽게 풀어 쓴 안내
AI 컴패니언 프라이버시: 대화 전 체크리스트