메인 콘텐츠로 건너뛰기
도구 세트를 사용하면 Didit MCP 연결이 전체 카탈로그 대신 짧은 도구 목록만 불러올 수 있으며, 읽기 전용 모드를 사용하면 데이터를 절대 변경할 수 없는 연결을 만들 수 있습니다. 두 기능 모두 서버 URL의 파라미터로 설정합니다:
파라미터를 지정하지 않으면 서버는 사용자의 역할로 사용할 수 있는 모든 도구를 나열합니다. 따라서 이미 사용 중인 연결에는 아무런 변화가 없습니다.

왜 도구를 적게 불러와야 하나요

클라이언트는 첫 질문 전에 나열된 모든 도구의 정의를 모델에 보냅니다. Didit 전체 카탈로그의 경우 요청마다 수만 토큰이 들며, 모델의 토크나이저에 따라 대략 50,000~115,000 토큰입니다. 일부 클라이언트는 받아들일 수 있는 도구 수에도 상한을 둡니다. 이 방식에는 단계가 하나 더 생긴다는 트레이드오프가 있습니다. 목록에 없는 도구가 사라지는 것은 아니지만, 모델은 실행하기 전에 도구 검색으로 그 도구를 찾아야 합니다. 그리고 모든 도구를 보고 있는 모델은 검색해야 하는 모델보다 올바른 도구를 조금 더 자주 고릅니다. 대화가 여러 영역에 걸쳐 있고 컨텍스트 비용이 문제되지 않는다면 전체를 불러오세요. 컨텍스트 비용이 문제가 된다면 core와 가장 자주 사용하는 도구 세트를 불러오세요.

도구 세트 선택

쉼표로 구분된 목록을 toolsets로 서버 URL에 추가합니다:
core는 대부분의 작업을 시작하는 짧은 목록입니다. 이 목록에는 조직과 애플리케이션, 인증 세션(생성, 조회, 결정, 설명, 샌드박스에서 시뮬레이션, webhook 전송 내역 읽기), 워크플로 찾기, 분석과 잔액, 애플리케이션의 API 키와 webhook, 케이스, 사용자, 기업, 거래 찾기, 그리고 문서 검색이 포함됩니다.
  • core: 위의 짧은 목록입니다.
  • account: 조직, 애플리케이션, API 키, 멤버 및 역할.
  • billing: 요금제, 크레딧 잔액, 결제 수단, 영수증 및 결제 정보.
  • sessions: 인증 세션(생성, 조회, 결정, 검토, 공유, 가져오기, PDF 및 webhook 전송 내역).
  • workflows: 인증 워크플로와 설문지(구축, 편집, 검증 및 게시).
  • lists: 사용자 지정 목록, 차단 목록 및 허용 목록.
  • vendors: 검증 대상인 사람과 회사(벤더 사용자 및 벤더 기업).
  • transactions: 거래 모니터링(거래, 지갑 스크리닝, 백테스팅을 포함한 규칙).
  • cases: 케이스 관리(케이스 생성, 담당자 지정, 에스컬레이션 및 해결).
  • investigator: Investigator(검토 대기열, 보고서, 결정, 정책 질문 및 성과).
  • webhooks: webhook 대상과 알림.
  • reports: 분석, 내보내기 및 감사 로그.
  • branding: 인증 흐름의 화이트 라벨 브랜딩.
  • verification: 독립형 인증 API(신분증, 얼굴, AML, 주소 증명, 전화번호, 이메일, 데이터베이스 및 기업 확인).
  • travel_rule: Travel Rule(설정, VASP 디렉터리, 네트워크, 주소, 전송 및 메시지).
  • marketplace: 공급자 마켓플레이스(카탈로그, 연결 및 연동 요청).
  • networks: 사기 네트워크(기기, 문서 또는 연락처를 공유하는 연결된 세션, 사용자 및 기업).
  • compliance: 컴플라이언스 어시스턴트(규제 프로필, 요구 사항, 그리고 이에 따라 생성된 워크플로).
  • docs: Didit 문서 검색.
  • all: 역할이 사용할 수 있는 모든 도구입니다. 기본값입니다.
도구 레퍼런스에는 모든 도구의 유형과 필요한 역할 권한이 나열되어 있습니다. 선택 방식은 다음과 같이 동작합니다:
  • 도구 세트는 선택 사항입니다. toolsets가 없는 URL은 모든 도구를 나열합니다.
  • 도구 세트 이름을 지정하면 해당 도구 세트만 나열됩니다. ?toolsets=cases는 케이스 도구와, 모든 연결이 받는 didit_context_get을 나열합니다. 짧은 목록도 유지하려면 core를 추가합니다.
  • 도구 세트는 나열되는 항목을 결정하며, 실행할 수 있는 항목을 결정하지 않습니다. 선택에 포함되지 않은 도구도 모델이 이름으로 호출하면 실행되며, 이때 적용되는 역할 권한은 항상 같습니다.
  • 서버가 알지 못하는 이름은 무시됩니다. 연결은 계속 작동하며, 서버는 무시된 이름과 유효한 이름 목록을 모델에 알려줍니다.
  • 역할은 여전히 적용됩니다. 도구 세트는 권한을 부여하지 않습니다. 역할 및 권한을 참고하십시오.

읽기 전용 모드로 연결하기

서버 URL에 read_only=true를 추가합니다:
읽기 전용 연결은 읽기 작업을 수행하는 도구만 나열하며, 서버는 무언가를 생성, 변경 또는 삭제하는 모든 호출을 거부합니다. 이 거부는 모든 호출에 대해 서버에서 이루어지므로, 클라이언트가 이전 연결에서 사용한 도구를 기억하고 있더라도 그대로 적용됩니다. 보고서 작성, 계정 살펴보기, 또는 스스로 작업을 수행하지 않기를 바라는 에이전트에 사용합니다. 변경을 다시 허용하려면 read_only 없이 연결합니다.

로드하지 않은 도구에 접근하기

연결에 전체 카탈로그 중 일부만 나열되면, 서버는 모든 도구에 접근할 수 있도록 다음 네 가지 도구를 추가합니다.
  • didit_tool_search (읽기): 원하는 작업(“세션을 CSV로 내보내기”)을 기준으로 도구를 찾거나, 도구 세트 하나를 나열합니다. 각 결과에는 도구가 하는 일, 파라미터, 그리고 읽기, 쓰기, 파괴적 작업 중 무엇인지가 표시됩니다.
  • didit_tool_describe (읽기): 최대 5개 도구의 전체 설명과 입력 스키마를 반환합니다.
  • didit_tool_call_read (읽기): 목록에 없는 읽기 전용 도구를 실행합니다. 데이터를 변경하는 도구는 실행을 거부합니다.
  • didit_tool_call_write (파괴적): 목록에 없으며 데이터를 생성, 변경 또는 삭제하는 도구를 실행합니다. 읽기 전용 연결에서는 제공되지 않습니다.
didit_tool_call_read 또는 didit_tool_call_write를 통한 호출도 직접 호출과 똑같이 검사됩니다. 역할 권한, 읽기 전용 모드, 그리고 모든 confirm: true 요구 사항이 그대로 적용됩니다. 두 도구를 분리한 이유는 클라이언트가 변경 작업 전에 사용자에게 확인을 요청하고, 조회는 별도로 허용할 수 있도록 하기 위해서입니다. core가 로드된 상태에서 “내 조직에 새 팀원 초대”와 같은 요청은 다음과 같이 처리됩니다.
  1. 모델이 invite a teammate를 검색어로 didit_tool_search를 호출하고, 쓰기 작업으로 표시된 didit_org_invite_member를 받습니다.
  2. 모델이 didit_org_invite_member를 name으로, 해당 도구 자체의 인수와 함께 전달하여 didit_tool_call_write를 호출합니다.
  3. 데이터를 변경하는 다른 도구와 마찬가지로, 클라이언트가 이 호출을 승인하도록 사용자에게 요청합니다.
모든 도구가 로드되어 있으면 더 찾아볼 도구가 없으므로 이 네 가지 도구는 나열되지 않습니다.

클라이언트에서 설정하기

설치 가이드와 같은 단계를 따르되, 파라미터를 URL에 추가하세요.
따옴표를 유지하세요. 그렇지 않으면 셸이 ?와 &를 직접 해석합니다.
클라이언트에서 URL은 수정할 수 없고 헤더만 설정할 수 있다면, X-MCP-Toolsets: core,workflows와 X-MCP-Readonly: true를 대신 보내세요. 도구 세트는 URL의 값이 헤더보다 우선합니다. 읽기 전용 모드는 둘 중 하나라도 요청하면 켜집니다.
ChatGPT 플러그인은 https://mcp.didit.me/mcp/chatgpt에서 고정된 축소 카탈로그를 사용합니다. 도구 세트와 읽기 전용 모드는 이 플러그인에 적용되지 않습니다. 자세한 내용은 ChatGPT 연결을 참고하세요.

프롬프트, 지침 및 문서 검색

서버는 모델이 올바른 지점에서 시작하도록 돕습니다:
  • 지침. 연결되면 서버는 모델에게 didit_context_get부터 시작하라고 알리고, organization_id와 application_id가 어떻게 해석되는지 설명하며, 샌드박스 애플리케이션에서 빌드하라고 안내하고, 이 연결이 로드한 툴셋이 무엇인지 알려 줍니다.
  • 프롬프트. MCP 프롬프트를 지원하는 클라이언트에는 다섯 가지 시작점이 표시됩니다: integrate_didit, review_queue, explain_session, build_workflow 및 verification_report. Claude Code에서는 슬래시 명령으로 나타납니다.
  • 문서 검색. didit_docs_search는 이 문서를 검색하여 일치하는 섹션과 해당 링크를 반환합니다. 따라서 Didit의 작동 방식에 대한 질문은 최신 페이지를 기준으로 답변됩니다.

연결이 로드한 항목 확인

클라이언트에 다음을 요청합니다:
모델은 서버의 지침을 기반으로 답변합니다. 툴셋을 지원하는지 사용하기 전에 확인하려면 서버의 상태 endpoint를 조회합니다:
응답에는 features 아래에 toolsets와 read_only가 나열됩니다.

다음 단계

설치

Claude, ChatGPT, Cursor, VS Code, Codex 또는 기타 MCP 클라이언트를 연결합니다.

도구 레퍼런스

각 도구, 해당 도구의 유형, 그리고 필요한 역할 권한을 확인합니다.

인증

Didit으로 로그인하고, 스코프 및 역할 권한을 확인합니다.

예시 프롬프트

첫날부터 바로 사용할 수 있는 프롬프트입니다.
마지막 수정일 2026년 11월 12일