연결 문제 해결

MashNote 연결 문제는 연결, 연결 승인, 도구 활성화, 자동 기록 프롬프트, 기록 위치 중 어느 단계에서 멈췄는지 확인하면 빠르게 해결할 수 있습니다. 단계별 설정 방법은 AI 도구 연결 및 자동 기록 (MCP)을 참고하세요.

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

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

1. 기존 대화나 작업을 닫고 새 대화 또는 새 작업을 엽니다.
2. 대화의 도구 메뉴에서 MashNote를 직접 활성화합니다.
3. MCP 도구 목록을 새로고침합니다.
4. MashNote 로그인 상태를 확인합니다. 로그인이 끝나지 않았다면 AI 도구에서 인증을 다시 시작하고, MashNote 연결 승인 페이지에서 허용을 누릅니다.
5. 그래도 보이지 않으면 연결을 제거한 뒤 AI 도구 연결 안내에 따라 다시 연결합니다.

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

• log_activity
• list_workspaces
• list_recent_activity

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

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

chatgpt.com

1. 사용자 설정 → Apps → Advanced Settings에서 Developer mode가 켜져 있는지 확인합니다.
2. Apps 설정에서 MashNote 앱을 새로고침합니다.
3. 새 대화를 열고 도구 메뉴에서 MashNote 앱을 직접 선택합니다.
4. 사용 중인 플랜과 워크스페이스 정책에서 사용자 지정 앱과 쓰기 도구를 허용하는지 확인합니다. ChatGPT 웹의 쓰기 도구는 플랜과 워크스페이스 정책에 따라 제한될 수 있습니다.

쓰기 도구가 계속 제한된다면 ChatGPT 데스크톱 앱이나 Codex CLI에서 MashNote 플러그인을 설치하는 방법을 고려하세요.

ChatGPT 데스크톱 앱 · Codex CLI

1. 플러그인 관리에서 https://github.com/lymeric-ai/mashnote-plugin.git 마켓플레이스와 MashNote 플러그인이 추가되어 있는지 확인합니다.
2. 기존 설치라면 앱에서 마켓플레이스를 갱신한 뒤 MashNote 플러그인을 업데이트하거나 재설치합니다.
3. OAuth 로그인과 노트 읽기·워크스페이스 승인을 완료합니다.
4. 데스크톱 앱을 재시작하거나 새 Codex CLI 세션을 시작합니다.
5. 새 대화에서 @MashNote를 선택합니다.
6. log_activity 등 MashNote 도구가 보이는지 확인합니다.

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

1. 새 대화를 엽니다.
2. Search and tools에서 MashNote를 켭니다.
3. 기존 대화가 아닌 새 대화에서 테스트합니다.
4. 권한은 켜져 있는데 도구가 없으면 Settings → Connectors에서 MashNote를 재연결한 뒤 새 대화를 엽니다.
5. Team 또는 Enterprise 조직이라면 소유자가 먼저 조직에 커넥터를 추가해야 할 수 있습니다.

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

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

1. CLI가 실제로 읽고 있는 사용자 설정과 프로젝트 설정을 확인합니다. 같은 MashNote 서버가 사용자 범위와 프로젝트 범위에 중복 등록되어 있지 않은지 살펴보세요.

2. 제품별 명령으로 상태를 확인합니다.

   제품	확인 방법
   Codex CLI	MashNote 플러그인의 설치와 OAuth 승인 확인. 새 세션에서 @MashNote 선택
   Claude Code	/mcp에서 MashNote가 connected인지 확인하고, 필요하면 인증 다시 시작
   Cursor CLI	agent mcp list로 연결 확인, agent mcp list-tools mashnote로 도구 확인. 로그인은 agent mcp login mashnote
   Antigravity CLI	/mcp에서 구성을 Reload하고 MashNote 상태와 도구 목록 확인

3. 기존 CLI를 종료하고 새 세션을 시작해 도구를 다시 불러옵니다.

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

1. 자동 기록 프롬프트를 적용했는지 확인합니다.
2. 프롬프트를 넣은 사용자 또는 프로젝트 지침이 현재 대화에 실제로 적용되는지 확인합니다.
3. 카드에서 고른 제품과 실제로 쓰는 제품이 같은지 확인합니다. 제품에 따라 대화형 AI용과 코딩 도구용 프롬프트가 다르게 만들어집니다.
4. 새 대화를 엽니다.
5. “MashNote에 테스트 활동 한 건을 기록해 줘”라고 명시적으로 요청합니다.

명시적인 요청에는 기록하지만 자동으로 기록하지 않는다면 프롬프트의 적용 위치 또는 프로젝트 범위를 다시 확인하세요. 프롬프트는 의미 있는 작업 단위가 끝났을 때만 기록하도록 쓰여 있으므로, 단순한 질문과 답변에는 기록하지 않는 것이 정상입니다.

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

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

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

연결 승인 페이지에 오류가 표시돼요

표시	의미와 해결 방법
잘못된 요청	연결 요청 정보가 올바르지 않습니다. 연결하던 AI 도구에서 연결을 처음부터 다시 시작하세요.
승인에 실패했어요. 잠시 후 다시 시도해 주세요.	잠시 후 허용을 다시 누르세요. 계속 실패하면 AI 도구에서 연결을 다시 시작하세요.
연결을 거부했어요	거부를 눌러 연결이 취소되었습니다. 창을 닫고 AI 도구에서 연결을 다시 시작하세요.
확인되지 않은 앱	앱 이름을 개발자가 직접 등록했고 MashNote가 확인하지 않았다는 경고입니다. 방금 직접 연결을 시작한 앱이 맞을 때만 허용하세요.

카드에 ’설정됨 · 기록 미확인’이 계속 표시돼요

AI 도구 연결 (MCP) 카드의 설정됨 · 기록 미확인은 연결이나 토큰은 있지만 아직 기록이 한 건도 들어오지 않았다는 뜻입니다.

1. 새 대화에서 MashNote 도구를 활성화합니다.
2. AI에게 “MashNote에 테스트 활동 한 건을 기록해 줘”라고 요청합니다.
3. AI가 기록에 성공했다고 답하면 카드 상태가 자동 기록 확인 · {date}로 바뀝니다. 설정 화면을 다시 열어 확인하세요.

AI가 기록하지 못했다고 답하면 연결했지만 MashNote 도구가 보이지 않아요부터 확인하세요.

카드에 ’연결 정보를 불러오지 못했어요’가 표시돼요

연결 정보를 불러오지 못했어요. 프롬프트는 만들 수 있지만 설치 주소를 확인하려면 잠시 후 다시 열어 주세요.가 표시되면 MashNote MCP 주소와 설치 단계가 표시되지 않습니다. 자동 기록 프롬프트는 이 상태에서도 만들 수 있습니다. 잠시 후 설정을 닫았다가 다시 열어 주세요.

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

1. 도구 목록에 log_activity가 있는지 확인합니다.
2. 기록 목적지를 확인합니다. 기본 프롬프트(나에게만 기록 (기본))로 기록한 활동은 내 매시에 나타납니다.
3. 특정 워크스페이스용 프롬프트를 쓴다면, 카드에서 그 워크스페이스를 골라 프롬프트를 다시 복사했는지 확인합니다. 내가 속하지 않은 워크스페이스 ID로는 기록할 수 없습니다.
4. 같은 idempotencyKey를 반복해서 보내고 있지 않은지 확인합니다. 같은 키로 보낸 기록은 중복으로 처리될 수 있습니다.
5. MashNote 화면을 새로고침합니다.

기록이 팀 활동 피드에 보이지 않아요

MCP로 들어온 활동은 기본적으로 나에게만 기록되어 내 매시에만 나타납니다. 팀의 활동 피드에 보이게 하려면 다음 중 하나를 사용하세요.

• 내 매시의 공개 범위 & 워크스페이스 연결에서 해당 소스의 기본 연결 워크스페이스를 정합니다. 규칙은 정한 뒤 기록되는 활동부터 적용됩니다.
• 내 매시에서 이미 기록된 활동을 골라 워크스페이스에 연결합니다.
• 특정 워크스페이스에 기록 프롬프트를 사용합니다.

워크스페이스에 연결한 뒤에도 보이지 않는다면 그 활동의 공개 범위를 확인하세요. 자세한 내용은 활동과 내 매시를 참고하세요.

접근 토큰이 동작하지 않아요

• 토큰은 발급 직후 한 번만 표시됩니다. 복사하지 못했다면 고급 설정 · 직접 연결에서 새 토큰을 발급하세요.
• 발급된 토큰 목록에서 만료일과 마지막 사용일을 확인합니다. 오래 사용하지 않은 토큰은 만료됩니다.
• 해제한 토큰은 다시 사용할 수 없습니다.
• 앱 설정에서 토큰을 Authorization: Bearer <토큰> 형식의 인증 헤더로 넣었는지 확인합니다.
• 토큰 발급에 실패했어요. 잠시 후 다시 시도해 주세요.가 표시되면 잠시 후 다시 시도하세요.

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

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

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

개발자이신가요?

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