안전 및 문제 해결

보안 경계

• 공급자 token 및 사용자 정의 OAuth 시크릿은 게이트웨이 자격증명 저장소에 보관됩니다. 프로젝트 파일, 브라우저 저장소, SQLite, 또는 로그에는 저장되지 않습니다.
• 계정을 연결하면 공급자 접근 권한이 부여됩니다. 모든 작업에 대한 포괄적인 접근 권한이 부여되는 것은 아닙니다. 해당 작업에 필요한 Connector만 활성화하십시오.
• 쓰기 작업은 하나의 계정으로 귀결되며, 작업별 확인 절차가 유지됩니다.
• 사용자 정의 MCP 도구는 기본적으로 비활성화 상태이며, 매번 확인이 필요합니다.
• 브로커리지 주문은 계정 확인, 미리 보기, 신규 확인, 재검증, 수령 확인의 절차를 거쳐야 합니다. 백그라운드 작업 및 하위 Agent는 주문을 제출할 수 없습니다.

연결 창이 성공 없이 닫히는 경우

권한 다이얼로그로 돌아가 오류 여부를 확인하십시오. OAuth 창이 닫히거나, 콜백이 만료되거나, 공급자가 접근을 거부하면 Minara는 로딩 상태를 종료합니다.

다음 사항을 확인하십시오.

1. Minara 사이트에 대한 팝업을 허용합니다.
2. 동일한 브라우저 프로파일에서 로그인을 완료합니다.
3. 콜백이 현재 게이트웨이에 도달했는지 확인합니다.
4. Manage connector에서 다시 시도합니다.
5. 버튼이 비활성화되어 있으면 상세 보기에서 사용 불가 사유를 확인합니다.

이전 인증 창이 아직 활성화된 상태에서 로그인을 반복하지 마십시오.

연결 사용 불가

현재 빌드에 필요한 공급자 연결이 없거나, 공급자가 통합 승인 과정 중이거나, Preview MCP 서비스가 활성화되지 않았을 수 있습니다. 상세 다이얼로그에서 사유를 확인할 수 있습니다. 사용 불가 상태의 Connector에 대해서는 Minara가 OAuth 상태를 생성하거나 창을 열지 않습니다.

연결 후 권한 거부

서비스 수준과 선택된 계정을 확인하십시오. 읽기 권한으로는 쓰기 작업을 수행할 수 없습니다. 접근 권한이 만료되거나 취소된 계정은 재연결이 필요합니다. 권한이 축소된 경우, Minara는 해당 작업을 즉시 차단합니다. 공급자에서 이전 스코프를 제거하려면 재연결하십시오.

MCP 도구 누락

기본 제공 오피스 Connector는 사전 검사 중에 작업 경로를 선택합니다. MCP 도구가 없고 기본 제공 어댑터가 해당 작업을 지원하는 경우에만 REST 경로가 사용됩니다. 런타임 타임아웃, 401, 429, 5xx, 스키마 불일치, 또는 알 수 없는 결과가 발생해도 경로가 전환되지 않습니다.

사용자 정의 MCP 및 브로커리지 Connector에는 REST 경로가 없습니다. MCP 서버 또는 해당 인증을 수정한 후 다시 시도하십시오.

클라우드 파일 충돌

Drive 및 OneDrive 업데이트는 eTag와 같은 공급자 버전 확인을 사용합니다. 파일을 새로 고침하고 최신 버전을 검토하십시오. Minara는 충돌하는 클라우드 편집 내용을 자동으로 덮어쓰지 않습니다.

클라우드 게시 실패

Connector 우선 전송 방식에서 Minara는 게시 전에 로컬 아티팩트의 정합성을 검증합니다. 클라우드 게시가 실패하더라도 로컬 파일은 계속 사용할 수 있습니다. 계정 또는 대상을 수정한 후 게시를 다시 시도하십시오.

주문 결과를 알 수 없는 경우

동일한 주문을 다시 제출하지 마십시오. Minara는 먼저 로컬 인텐트 ID와 공급자 주문 상태를 대조합니다. 주요 필드, 예상 비용, 계정 상태, 또는 미리 보기가 변경된 경우 추가 확인을 요청합니다.

브로커 스냅샷은 세금, 회계, TWR, XIRR, 또는 감사 등급의 과거 데이터를 지원하지 않습니다. 해당 작업에 필요한 기록은 브로커 또는 수탁기관에서 직접 내보내십시오.

유료 MCP의 payment required 응답

x402 요금에 exact, 공식 USDC, EVM 또는 Solana 네트워크가 있는지 확인하세요. 지원하지 않는 방식이나 자산을 일반 지갑 전송으로 바꾸지 않습니다. 결제 후 동일한 MCP 호출을 한 번만 다시 실행합니다.

직접 연결에서 challenge_id가 없으면 402 응답이 프로토콜에 맞지 않을 수 있습니다. 호스팅 Broker는 x402 헤더를 전달해야 합니다. 결과가 불확실하면 상태를 먼저 확인하고 중복 결제하지 마세요.