@myhero/mcp-server

HERO용 MCP 서버 — Claude Desktop, Cursor, Claude Code 및 모든 stdio MCP 클라이언트와 같은 AI 도구가 사용자의 HERO 문서, 프로젝트 및 테이블을 읽고 쓸 수 있게 합니다.

빠른 시작

AI 도구의 MCP 설정에 추가하세요:

{
  "mcpServers": {
    "hero": {
      "command": "npx",
      "args": ["-y", "@myhero/mcp-server"],
      "env": {
        "HERO_API_KEY": "hero_at_your_token_here"
      }
    }
  }
}

app.myhero.so → 설정 → MCP 토큰에서 토큰을 생성하세요.

Claude Desktop, Cursor, Claude Code 및 기타 도구에 대한 단계별 설정은 **myhero.so/mcp-setup의 전체 가이드**를 참조하세요.

주요 기능

문서

• 모든 문서 읽기 — 전체 콘텐츠, 일반 텍스트, 메타데이터 또는 섹션 제목만 읽기

• 모든 워크스페이스 및 프로젝트 검색

• 새 문서 생성, 이름 변경, 이동, 복제 또는 삭제

• 스냅샷 생성, 문서 내 모든 블록 나열, 번호 매기기를 통해 섹션으로 이동

• 정밀 편집: 전체 HERO 블록 스키마를 다시 작성하지 않고 단일 단락, 제목, 목록 항목 또는 테이블 변경.

조항 및 법적 구조

• 계약서 및 합의서 내의 조항, 하위 조항 및 정의 읽기, 나열 및 편집

• 특정 조항이나 정의된 용어를 참조하는 모든 문서 찾기

• 정의를 소유한 문서에서 직접 정의에 대한 설명 가져오기

프로젝트, 폴더 및 워크스페이스

• 워크스페이스, 프로젝트, 폴더 및 그 안의 문서 나열

• 프로젝트 생성, 이름 변경, 문서를 폴더로 정리

• 프로젝트 간 문서 일괄 이동 또는 복사

테이블

• 테이블 생성, 열 및 행 추가/삭제, 동적 값 설정.

• 전체 테이블 읽기, 이름으로 특정 행, 열 또는 셀 조회

• 셀을 하나씩 또는 일괄 업데이트

• 문서 내에서 행을 참조하여 문서와 테이블 간의 동기화 유지

템플릿 및 플레이스홀더

• 테이블에서 데이터를 가져오는 실시간 플레이스홀더가 포함된 재사용 가능한 문서 템플릿 구축

• 기본 테이블 데이터가 변경되면 이를 참조하는 모든 문서가 자동으로 업데이트됨

인증

두 가지 인증 방법:

1. 개인 액세스 토큰 (HERO_API_KEY 환경 변수) — 헤드리스 설정에 권장됩니다.

2. OAuth 로그인 — 환경 변수를 생략하면 처음 사용할 때 브라우저가 열립니다. 토큰은 ~/.hero/credentials.json에 저장됩니다.

app.myhero.so → 설정 → MCP 토큰에서 토큰이나 세션을 관리하고 취소하세요.

환경 변수

소스

소스는 github.com/Unwynd-io/hero-mcp에 있습니다. 이슈 및 풀 리퀘스트를 환영합니다.