mcp-me v0.6.0을 사용하여 여러 MCP 클라이언트에서 하나의 로컬 AI 프로필 공유하기

npx --yes [email protected] init
npx --yes [email protected] validate

cat ~/.mcp-me/.mcp-me.yaml

Get-Content "$HOME\.mcp-me\.mcp-me.yaml"

generators:
  github: your-username
  devto: your-username
...

npx --yes [email protected] generate
npx --yes [email protected] validate

npx --yes [email protected] init ./my-ai-profile
npx --yes [email protected] validate ./my-ai-profile
npx --yes [email protected] generate ./my-ai-profile

npx -y mcp-me serve

{

Cursor의 경우, 프로젝트 내 `.cursor/mcp.json` 또는 전역 서버에 사용되는 클라이언트 설정에서 동일한 서버 항목을 배치하세요:

VS Code는 다른 최상위 키를 사용합니다. `.vscode/mcp.json`에서는 `servers`를 사용하세요:

이러한 클라이언트 예시는 [v0.6.0 README 구성 섹션](https://github.com/paladini/mcp-me/tree/v0.6.0#configure-your-ai-assistant)에서 가져왔습니다. Claude Desktop은 [v0.6.0 GitHub 릴리스](https://github.com/paladini/mcp-me/releases/tag/v0.6.0)에 첨부된 `.mcpb` 에셋을 사용하거나, 프로젝트가 문서화한 수동 MCP 구성을 사용할 수 있습니다.

## 서버 경계 확인하기 (Verify the server boundary)

클라이언트를 연결하기 전에 CLI를 사용하여 도움말을 요청하고 프로필을 다시 검증하세요:

그런 다음 터미널에서 서버를 시작하세요:

MCP 클라이언트는 일반적으로 표준 입력 및 출력(standard input and output)을 통해 이 프로세스를 자체적으로 실행합니다. 따라서 유용한 검증은 클라이언트 측에서 이루어져야 합니다. 즉, `me` 서버에 연결하고, 클라이언트에게 프로필 리소스 읽기를 요청한 다음, 그 답변이 검토했던 YAML과 일치하는지 확인해야 합니다. 성공적인 프로세스 시작을 모든 생성기(generator)나 플러그인이 작동한다는 증거로 여겨서는 안 됩니다.

프로필 위치를 명시적으로 지정해야 하는 경우, 클라이언트 프로세스 환경에 `MCP_ME_PROFILE_DIR`를 설정하거나 `serve` 명령어에 디렉토리를 전달하세요. [릴리스 README](https://github.com/paladini/mcp-me/blob/v0.6.0/README.md)에서 두 가지 옵션 모두 문서화하고 있습니다.

## 이것이 작동하는 이유 (Why this works)

프로필 파일과 `.mcp-me.yaml` 구성은 로컬 컨텍스트의 원천을 형성합니다. MCP 서버는 이 컨텍스트를 프로토콜(protocol)을 통해 노출하며, 각 클라이언트는 언제 이를 읽을지 결정하는 책임이 남아 있습니다. 이는 긴 명령어 블록을 모든 클라이언트에 복사하는 것과는 다릅니다. 데이터는 단 하나의 정규 위치(canonical location)를 가지며, 변경 사항은 일반 파일 도구로 검토할 수 있습니다.

이 디자인은 또한 생성된 데이터와 라이브 통합 사이에 유용한 경계를 남깁니다. 생성된 YAML은 사용 전에 검사할 수 있습니다. 플러그인은 어시스턴트가 값을 조회할 때 현재 값을 제공할 수 있습니다. 이러한 분리는 플러그인을 비활성화하거나, 필드를 제거하거나, 민감한 카테고리를 프로필에서 제외하는 것을 더 쉽게 만듭니다.

## 실패 모드 및 제한 사항

### 클라이언트가 `npx`를 찾을 수 없음

GUI 애플리케이션은 터미널과 동일한 PATH를 상속받지 못할 수 있습니다. 환경 구성을 위해 클라이언트 문서를 확인하거나, Node.js 설치의 절대 경로를 사용하십시오. 이 오류는 프로필 유효성 검사 실패가 아니라 프로세스 발견 문제입니다.

### YAML 편집 후 유효성 검사 실패

프로필 디렉터리를 사용하여 `validate`를 실행하고 첫 번째 보고된 파일을 읽으십시오. 스키마나 값을 수정한 다음, 다시 유효성 검사를 실행하십시오. 유효성 검사되지 않은 프로필을 연결하고 클라이언트가 문제를 설명해 줄 것이라고 가정하지 마십시오.

### 소스가 불완전한 데이터를 반환하는 경우

생성기는 소스의 공개 API, 피드 또는 내보내기 형식에 의존합니다. 유효한 로컬 프로필이 원격 소스가 완전한 데이터를 반환했음을 증명하지는 않습니다. 생성된 파일을 검토하고 신뢰하기 전에 해당 소스별 문서를 참조하십시오.

### 로컬이라는 것이 위험으로부터 자유롭다는 것을 의미하지 않음

이 프로젝트는 로컬 YAML 파일을 중심으로 설계되었지만, 이러한 파일을 읽을 수 있는 모든 MCP 클라이언트는 그 내용을 모델 컨텍스트에 배치할 수 있습니다. 비밀번호, 개인 키, 액세스 토큰 또는 비밀 정보를 프로필에 넣지 마십시오. 프로젝트에서 문서화된 플러그인 설정과 운영 체제의 파일 권한을 사용하십시오. MIT 라이선스와 로컬 실행은 보안 보증을 구성하지 않습니다.

튜토리얼에서는 안정 버전인 v0.6.0 릴리스를 사용합니다. 리포지토리의 기본 브랜치에는 더 새롭거나 미출시된 동작이 포함될 수 있으므로, 새로운 환경에 명령어를 복사하기 전에 [현재 변경 로그](https://github.com/paladini/mcp-me/blob/main/CHANGELOG.md)를 확인하십시오.

## FAQ

### `mcp-me`를 전역으로 설치해야 하나요?

## FAQ

### `mcp-me`를 전역으로 설치해야 하나요?

아닙니다. 위에 설명된 명령어들을 사용하려면 `npx --yes [email protected]`만 충분합니다. 글로벌 npm 설치가 반복적인 사용에 편리하지만, 버전을 고정하는 것이 튜토리얼과 재현 가능한 검사를 더 명확하게 만듭니다.

### 여러 클라이언트가 다른 프로필을 사용할 수 있나요?

네. 클라이언트 프로세스에 명시적인 디렉터리를 전달하거나 `MCP_ME_PROFILE_DIR`를 설정하십시오. 청중이나 데이터의 민감도가 다를 때는 별도의 프로필을 사용하세요.

### `mcp-me`가 이전 대화를 기억하나요?

아닙니다. 이는 MCP를 통해 프로필 데이터와 구성된 라이브 리소스를 노출할 뿐입니다. 대화 기록, 모델 동작, 클라이언트 측 컨텍스트 정책은 별개의 관심사로 유지됩니다.

## 핵심 요약 (Takeaway)

검토된 프로필 디렉터리를 공유 컨텍스트 레이어로 사용하고, 편집할 때마다 이를 검증하며, 모든 MCP 클라이언트를 동일한 `mcp-me serve` 명령어에 연결하십시오. 공개적이고 위험도가 낮은 필드부터 시작하세요. 생성기(generators)와 플러그인은 해당 데이터가 무엇을 읽는지, 그리고 클라이언트가 모델로 무엇을 보낼 수 있는지 이해할 때만 추가하세요.

여러분의 AI 도구 전반에 걸쳐 로컬로 유지하고 공유할 첫 번째 프로필 카테고리는 기술 스킬(skills), 프로젝트(projects), 경력 이력(career history) 중 어느 것인가요, 아니면 다른 무언가인가요?

> AI 지원 공개: 본 튜토리얼을 구성하고 편집하는 데 AI 도움을 받았습니다. 명령어, 버전 주장, 구성 예시 및 스모크 테스트 결과는 `mcp-me` v0.6.0 릴리스와 해당 주요 프로젝트 문서를 기반으로 확인되었습니다.