AI 도구 연결 및 자동 기록 (MCP)

MashNote에 AI 도구를 연결한다는 것은 해당 도구에 MashNote를 MCP 커넥터 또는 MCP 서버로 추가하고 로그인하는 것을 뜻합니다.

MCP(Model Context Protocol)는 AI 도구가 외부 서비스의 기능을 사용할 수 있게 연결하는 표준입니다. 이 문서에서는 처음 한 번만 전체 이름을 설명하고, 이후에는 MCP로 표기합니다.

연결과 활성화는 다른 단계입니다

연결 성공과 도구 활성화는 서로 다른 단계입니다. 연결 후 새 대화나 새 작업에서 MashNote 도구를 활성화해야 자동 기록을 사용할 수 있습니다.

시작하기 전에

1. MashNote에서 **개인 설정 → 연동 → AI 도구 연결(MCP)**로 이동합니다.
2. 화면에 표시된 연결 주소를 복사합니다.
3. 아래에서 사용하는 AI 도구를 선택합니다.

연결 주소는 계정에 연결될 수 있는 민감한 정보입니다. 스크린샷이나 공개 문서에 주소 전체가 보이지 않도록 주의하세요.

모든 AI 도구의 공통 연결 흐름

제품마다 메뉴 이름은 다르지만 연결 과정은 다음 네 단계로 같습니다.

1. MashNote의 **개인 설정 → 연동 → AI 도구 연결(MCP)**에서 연결 주소를 확인합니다.
2. AI 도구에 MashNote 커넥터 또는 서버를 추가하고 로그인합니다.
3. 새 대화나 새 작업을 열고 MashNote 도구를 활성화합니다.
4. 자동 기록 프롬프트를 적용합니다.

제품별 연결 방법

ChatGPT

chatgpt.com

1. ChatGPT 사용자 설정에서 Apps → Advanced Settings로 이동합니다.
2. Developer mode를 활성화합니다.
3. Apps에서 새 사용자 지정 앱을 만듭니다.
4. 앱 이름을 MashNote로 입력합니다.
5. MashNote에서 복사한 MCP 연결 주소를 입력합니다.
6. Scan Tools를 실행하고 OAuth 로그인과 권한 승인을 완료합니다.
7. 사용자 지정 앱 생성을 완료합니다.
8. 새 대화를 엽니다.
9. 대화의 도구 메뉴에서 MashNote를 직접 선택합니다.

새 대화에서 MashNote를 선택하세요

앱을 생성한 것만으로는 도구가 자동으로 활성화되지 않을 수 있습니다. 새 대화의 도구 메뉴에서 MashNote를 직접 선택한 뒤 작업을 시작하세요.

참고

ChatGPT 웹에서는 플랜이나 워크스페이스 정책에 따라 log_activity 같은 쓰기 도구가 제한될 수 있습니다. 도구 목록에 log_activity가 없다면 ChatGPT 문제 해결 안내를 확인하세요.

ChatGPT 데스크톱 앱 · Codex CLI

ChatGPT 데스크톱 앱은 자동 기록 시연과 쓰기 도구 사용에 권장합니다. 데스크톱 앱과 Codex CLI는 같은 MCP 설정을 공유할 수 있습니다.

방법 1: 데스크톱 앱 설정에서 추가

1. ChatGPT 데스크톱 앱에서 Settings → MCP servers로 이동합니다.
2. Add server를 선택합니다.
3. 이름에 MashNote를 입력합니다.
4. 연결 방식으로 Streamable HTTP를 선택합니다.
5. MashNote에서 복사한 연결 주소를 입력하고 저장합니다.
6. OAuth 로그인이 표시되면 Authenticate를 선택해 로그인합니다.
7. 데스크톱 앱을 다시 시작합니다.
8. 새 대화나 새 Codex 작업에서 MashNote 도구를 활성화합니다.

방법 2: Codex CLI에서 추가

PowerShell에서 다음 명령을 실행합니다. <MASHNOTE_MCP_URL>은 MashNote에서 복사한 연결 주소로 바꾸세요.

codex mcp add mashnote --url <MASHNOTE_MCP_URL>
codex mcp login mashnote

Codex를 새로 시작한 뒤 /mcp를 입력해 mashnote가 연결되어 있는지 확인합니다. 프로젝트에서 계속 자동 기록하려면 저장소의 AGENTS.md에 특정 워크스페이스용 프롬프트를 추가하는 방법을 권장합니다.

Claude

Claude 웹·데스크톱 앱

원격 MCP 커넥터는 Claude 계정에 연결되므로 claude.ai와 Claude 데스크톱 앱에서 같은 연결을 사용합니다.

1. Claude에서 Settings → Connectors로 이동합니다.
2. Add custom connector를 선택합니다.
3. 이름을 MashNote로 입력합니다.
4. MashNote에서 복사한 원격 MCP 연결 주소를 입력합니다.
5. 로그인과 권한 승인을 완료합니다.
6. Connectors에서 MashNote가 active 상태인지 확인합니다.
7. 새 대화를 엽니다.
8. Search and tools에서 MashNote를 활성화합니다.

active 표시는 계정 연결 상태입니다. 새 대화에서 MashNote를 활성화하고 실제 도구 목록을 확인해야 자동 기록 준비가 끝납니다.

Claude Code (CLI)

PowerShell에서 다음 명령을 실행합니다.

claude mcp add --transport http mashnote <MASHNOTE_MCP_URL>

1. Claude Code를 시작합니다.
2. /mcp를 입력합니다.
3. mashnote를 선택하고 OAuth 인증을 완료합니다.
4. 상태가 connected인지 확인합니다.
5. MashNote의 도구 목록에 log_activity, list_workspaces, list_recent_activity가 보이는지 확인합니다.
6. 새 Claude Code 세션을 열어 도구를 다시 불러옵니다.
7. 프로젝트의 CLAUDE.md에 자동 기록 프롬프트를 추가합니다.

다른 프로젝트에서도 같은 연결을 사용하려면 사용자 범위로 등록할 수 있습니다.

claude mcp add --transport http --scope user mashnote <MASHNOTE_MCP_URL>

Cursor

Cursor에서는 설정 화면 또는 mcp.json으로 MashNote를 추가할 수 있습니다.

설정 화면에서 추가

1. Cursor에서 Settings → Tools & Integrations → MCP Tools로 이동합니다.
2. 새 MCP 서버 추가를 선택합니다.
3. 이름을 MashNote로 입력합니다.
4. 전송 방식으로 원격 Streamable HTTP를 선택합니다.
5. MashNote에서 복사한 연결 주소를 입력합니다.
6. 로그인과 권한 승인을 완료합니다.
7. MCP 도구 목록을 새로고침합니다.
8. 새 Agent 작업을 열고 MashNote 도구를 활성화합니다.

mcp.json으로 추가

사용자 설정은 ~/.cursor/mcp.json, 프로젝트 설정은 프로젝트 루트의 .cursor/mcp.json에 추가합니다.

{
  "mcpServers": {
    "mashnote": {
      "url": "<MASHNOTE_MCP_URL>"
    }
  }
}

파일을 저장한 뒤 Cursor의 MCP 도구 목록을 새로고침하고 새 Agent 작업을 여세요. 프로젝트에서 계속 자동 기록하려면 Cursor Rules에 자동 기록 프롬프트를 추가하세요.

Antigravity

Antigravity에서는 설정 화면 또는 설정 파일로 MashNote를 추가할 수 있습니다.

설정 화면에서 추가

1. Antigravity에서 Settings → Customizations로 이동합니다.
2. **Add MCP+**를 선택합니다.
3. 원격 MCP 서버 이름을 MashNote로 입력합니다.
4. MashNote에서 복사한 연결 주소를 입력합니다.
5. 서버를 저장하고 인증을 완료합니다.
6. Installed MCP Servers에서 Refresh를 선택합니다.
7. 새 Agent 작업을 열고 MashNote 도구를 활성화합니다.

설정 파일로 추가

사용자 설정 파일 ~/.gemini/antigravity/mcp_config.json을 열거나 만듭니다. 프로젝트에만 적용하려면 프로젝트 루트의 .agents/mcp_config.json을 사용합니다.

{
  "mcpServers": {
    "mashnote": {
      "serverUrl": "<MASHNOTE_MCP_URL>"
    }
  }
}

파일을 저장한 뒤 Settings → Customizations → Installed MCP Servers에서 Refresh를 선택합니다. Antigravity CLI를 사용한다면 새 CLI 세션을 열고 /mcp에서 인증 상태와 도구 목록을 확인하세요.

기타 MCP 지원 도구

사용 중인 AI 도구가 다음 기능을 지원하는지 먼저 확인하세요.

• 원격 Streamable HTTP MCP 서버
• OAuth 로그인
• MCP 도구 목록 새로고침

지원한다면 다음 순서로 연결합니다.

1. MashNote에서 연결 주소를 복사합니다.
2. AI 도구의 MCP 서버 설정에 주소를 등록합니다.
3. OAuth 로그인을 완료합니다.
4. 도구 목록을 새로고침합니다.
5. 새 대화나 새 작업에서 MashNote를 활성화합니다.

OAuth를 지원하지 않는 앱에서는 접근 토큰을 사용하는 고급 연결이 필요할 수 있습니다. 토큰은 설정 파일에 직접 적기보다 앱이 제공하는 보안 저장소나 환경 변수를 사용하세요.

사용 중인 앱이 사용자 지침 또는 프로젝트 지침을 지원한다면 해당 위치에 자동 기록 프롬프트를 추가하세요.

도구 활성화 확인

Connected 또는 Active 표시만으로는 자동 기록 준비가 끝난 것이 아닙니다. 새 대화나 새 작업에서 MashNote 도구가 실제로 보이는지 확인하세요.

1. 새 대화 또는 새 작업을 엽니다.

2. MashNote 도구를 직접 활성화합니다.

3. 도구 목록을 새로고침합니다.

4. 다음 세 도구가 표시되는지 확인합니다.

   • log_activity
   • list_workspaces
   • list_recent_activity

5. AI에게 “MashNote에 테스트 활동 한 건을 기록해 줘”라고 요청합니다.

6. MashNote 활동 피드에 테스트 활동이 나타나는지 확인합니다.

주의

log_activity가 보이지 않으면 자동 기록을 사용할 수 없습니다. 연결 문제 해결의 제품별 안내를 확인하세요.

자동 기록 프롬프트

자동 기록 프롬프트는 영어로 제공됩니다. 아래에서 기록 목적지에 맞는 한 가지만 복사해 사용하세요.

기본 기록

워크스페이스를 따로 지정하지 않고 나의 기본 위치에 기록할 때 사용합니다. 기록 위치를 별도로 지정하지 않으면 나에게 기본 기록됩니다.

At the end of each meaningful turn, append one MashNote activity entry with the log_activity tool. Log turns that create or change files, make a decision, run tests or verification, or finalize a plan or scope. Do not log read-only exploration, pure Q&A, trivial commands, or throwaway experiments. Use a concise title and summary, add points only when there are several distinct changes, and put PR-sized detail in detail. Record to my personal default destination without asking me to choose a workspace and without calling list_workspaces. Use a unique idempotencyKey. Never include secrets or sensitive personal information.

이 프롬프트는 매번 기록 위치를 묻지 않으며, list_workspaces를 먼저 호출하지 않습니다.

특정 워크스페이스에 기록

프로젝트, 수업 또는 연구실처럼 기록 위치가 정해져 있다면 다음 프롬프트를 사용합니다. <WORKSPACE_NAME_OR_ID>를 실제 워크스페이스 이름이나 ID로 바꾸세요.

At the end of each meaningful turn, append one MashNote activity entry to <WORKSPACE_NAME_OR_ID> with the log_activity tool. Log turns that create or change files, make a decision, run tests or verification, or finalize a plan or scope. Do not log read-only exploration, pure Q&A, trivial commands, or throwaway experiments. If the workspace ID is not already known, call list_workspaces once to resolve the named destination and reuse it for the rest of the session. Use a concise title and summary, add points only when there are several distinct changes, and put PR-sized detail in detail. Use a unique idempotencyKey. Never include secrets or sensitive personal information.

특정 프로젝트에서 계속 사용한다면 다음과 같은 프로젝트 지시사항에 넣는 방법을 권장합니다.

• ChatGPT Project의 Instructions
• Claude Project의 Project instructions
• Codex의 AGENTS.md
• Claude Code의 CLAUDE.md
• Cursor Rules

같은 대화나 작업 흐름을 나중에 묶기 위해 프롬프트에 해시태그를 추가할 수도 있습니다. 해시태그는 기록 목적지가 아니라 line of work를 구분하는 보조 정보입니다.

기록 위치와 공개 범위

MCP 활동의 공개 범위는 활동이 처음 기록된 위치에 따라 달라집니다.

• 개인 기본 경로로 기록된 활동: 나의 기본 활동으로 기록됩니다.
• 특정 워크스페이스로 직접 기록된 활동: 해당 워크스페이스의 활동이며 그 워크스페이스의 공개 규칙을 따릅니다.
• GitHub 등 워크스페이스 연동에서 들어온 활동: 연결된 워크스페이스의 규칙을 따릅니다.

특정 워크스페이스의 활동도 내 매시에 함께 나타날 수 있습니다. 이때 활동에는 어느 워크스페이스에서 왔는지 출처가 표시됩니다. 워크스페이스에서 발생한 활동의 공개 범위는 내 매시의 개인 공개 설정이 아니라 원래 기록된 워크스페이스의 규칙을 따릅니다.

자세한 내용은 활동 피드와 공개 범위를 확인하세요.

연결 해제

MashNote의 **개인 설정 → 연동 → AI 도구 연결(MCP)**에서 연결을 해제할 수 있습니다. 같은 MCP 클라이언트의 다른 세션에도 영향을 줄 수 있으므로 해제 전에 사용 중인 작업을 확인하세요. 이미 기록된 활동은 삭제되지 않습니다.

연결이나 도구 활성화에 문제가 있으면 연결 문제 해결을 확인하세요.

개발자이신가요?

MCP 설정 파일을 직접 편집하거나 기술적인 구성과 예제를 확인하려면 MashNote MCP GitHub 저장소를 참고하세요.