연결 문제 해결

MashNote 연결 문제는 연결, 도구 활성화, 자동 기록 프롬프트 중 어느 단계에서 멈췄는지 확인하면 빠르게 해결할 수 있습니다.

연결했지만 MashNote 도구가 보이지 않아요

다음 순서대로 확인하세요.

1. 기존 대화나 작업을 닫고 새 대화 또는 새 작업을 엽니다.
2. 대화의 도구 메뉴에서 MashNote를 직접 활성화합니다.
3. MCP 도구 목록을 새로고침합니다.
4. MashNote 로그인 상태를 확인합니다.
5. 연결을 해제한 뒤 AI 도구 연결 안내에 따라 다시 연결합니다.

도구 목록에 다음 세 도구가 보여야 합니다.

• log_activity
• list_workspaces
• list_recent_activity

log_activity가 없으면 자동 기록을 사용할 수 없습니다.

도구는 보이지만 AI가 호출하지 않아요

1. 자동 기록 프롬프트를 적용했는지 확인합니다.
2. 프롬프트를 넣은 사용자 또는 프로젝트 지시사항이 현재 대화에 실제로 적용되는지 확인합니다.
3. 프롬프트에 작업 종료 시 log_activity를 호출하라는 지시가 포함되어 있는지 확인합니다.
4. 새 대화를 엽니다.
5. “MashNote에 테스트 활동 한 건을 기록해 줘”라고 명시적으로 요청합니다.

명시적인 요청에는 기록하지만 자동으로 기록하지 않는다면 프롬프트의 적용 위치 또는 프로젝트 범위를 다시 확인하세요.

ChatGPT에서 도구가 보이지 않아요

1. Apps → Advanced Settings에서 Developer mode가 켜져 있는지 확인합니다.
2. MashNote가 Enabled Apps에 있는지 확인합니다.
3. 사용자 지정 앱의 Actions 또는 도구 목록을 새로고침합니다.
4. 새 대화를 엽니다.
5. 도구 메뉴에서 MashNote 앱을 직접 선택합니다.
6. 사용 중인 플랜과 워크스페이스 정책에서 사용자 지정 앱과 쓰기 도구를 허용하는지 확인합니다.

ChatGPT 데스크톱 앱이나 Codex CLI에서는 /mcp를 입력해 연결 상태와 도구 목록을 확인하세요.

Claude에서 active인데 호출하지 않아요

1. 새 대화를 엽니다.
2. Search and tools에서 MashNote를 활성화합니다.
3. 기존 대화가 아닌 새 대화에서 테스트합니다.
4. Settings → Connectors에서 MashNote 연결을 해제한 뒤 다시 연결합니다.
5. Team 또는 Enterprise 조직 정책이 사용자 지정 커넥터를 허용하는지 확인합니다.

active는 커넥터의 계정 연결 상태입니다. 현재 대화에서 MashNote 도구가 활성화되었다는 뜻은 아닙니다.

CLI에서 연결 상태가 다르게 보여요

1. CLI가 실제로 읽고 있는 사용자 설정 파일과 프로젝트 설정 파일을 확인합니다.
2. /mcp 또는 제품별 MCP 목록 명령을 실행합니다.
3. 같은 MashNote 서버가 사용자 범위와 프로젝트 범위에 중복 등록되어 있는지 확인합니다.
4. OAuth 인증을 다시 실행합니다.
5. 기존 CLI를 종료하고 새 세션을 시작합니다.

Codex CLI에서는 다음 명령으로 확인할 수 있습니다.

codex mcp list
codex mcp login mashnote

Claude Code에서는 다음 명령과 대화 내 명령을 사용할 수 있습니다.

claude mcp list
claude mcp login mashnote

/mcp

여러 AI 계정을 연결할 수 있나요?

같은 AI 도구의 여러 계정에서 MashNote에 로그인할 수는 있지만, 현재 MashNote에서는 해당 AI 계정을 각각 이름으로 표시하거나 개별적으로 연결 해제할 수 없습니다.

MashNote는 연결을 원격 AI 계정 이름이 아니라 MCP 클라이언트 단위로 관리합니다. 같은 클라이언트의 연결을 해제하면 해당 클라이언트의 다른 계정이나 세션에도 영향을 줄 수 있습니다.

로그인 창이 열리지 않거나 인증이 반복돼요

1. AI 도구에서 MashNote 연결을 제거합니다.
2. AI 도구를 완전히 종료한 뒤 다시 엽니다.
3. MashNote 연결 주소를 다시 복사해 등록합니다.
4. 브라우저에서 MashNote에 로그인되어 있는지 확인합니다.
5. 팝업 차단 또는 조직의 OAuth 제한이 있는지 확인합니다.
6. 인증 후 새 대화나 새 CLI 세션을 시작합니다.

개인 MCP 연결 주소나 접근 토큰을 지원 문의, 스크린샷 또는 공개 이슈에 포함하지 마세요.

테스트 활동이 기록되지 않아요

1. 도구 목록에 log_activity가 있는지 확인합니다.
2. 기록 목적지가 개인 기본 경로인지 특정 워크스페이스인지 확인합니다.
3. 특정 워크스페이스를 사용한다면 이름 또는 ID가 정확한지 확인합니다.
4. 같은 idempotencyKey를 반복 사용하고 있지 않은지 확인합니다.
5. MashNote의 활동 피드를 새로고침합니다.

특정 워크스페이스로 기록한 활동은 내 매시에도 출처와 함께 나타날 수 있습니다. 공개 범위는 활동이 처음 기록된 위치의 규칙을 따릅니다.

개발자이신가요?

MCP transport, OAuth, 접근 토큰, 직접 설정 예제를 확인하거나 기술 문제를 신고하려면 MashNote MCP GitHub 저장소를 참고하세요.