모두싸인 MCP 서버 연동 가이드

모두싸인의 MCP(Model Context Protocol) 서버를 통해 Cursor, Claude Desktop, Claude Code 등 AI 기반 도구들이 Modusign API 및 문서와 직접 연동할 수 있습니다.

MCP란 무엇인가요?

MCP(Model Context Protocol)는 AI 애플리케이션이 외부 데이터 소스와 도구에 안전하게 접근할 수 있도록 하는 개방형 표준입니다.

MCP가 제공하는 핵심 기능

Modusign MCP 서버는 AI 에이전트에게 다음과 같은 기능을 제공합니다:

직접 API 접근: Modusign의 모든 기능에 바로 접근
문서 검색 기능: 필요한 정보를 즉시 찾아서 활용
실시간 데이터: 사용자의 Modusign 계정 정보를 실시간으로 가져옴
코드 생성 지원: Modusign 연동을 위한 코드를 자동으로 생성

설정 방법

Modusign은 https://developers.modusign.co.kr/mcp 주소에서 원격 MCP 서버를 제공합니다.

📘
중요: 인증이 필요한 API 사용 시 쿼리 파라미터나 헤더를 통해 인증 정보를 전달해야 합니다.

사용자 이메일과 발급받은 API KEY를 콜론(:)으로 붙여 구성합니다.

구성 된 문자열을 base64인코딩 처리 합니다.

아래와 같이 Authorization헤더에 Basic타입으로 인코딩 된 문자열을 포함하여 요청하려는 API의 주소로 정보를 요청합니다.

기본 설정

Cursor Settings → Tools & Integrations → New MCP Server에서 다음 설정을 추가하세요.

설정 파일 위치:

Windows: C:\Users\[사용자명]\.cursor\mcp.json
macOS/Linux: ~/.cursor/mcp.json

{
  "mcpServers": {
    "modusign": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://developers.modusign.co.kr/mcp"
      ]
    }
  }
}

MCP 권한 설정 (인증 필요시)

API 접근 권한이 필요한 경우 다음과 같이 인증 헤더를 추가하세요:

{
  "mcpServers": {
    "modusign": {
      "command": "npx", 
      "args": [
        "mcp-remote",
        "https://developers.modusign.co.kr/mcp",
        "--header",
        "Authorization:${MODUSIGN_AUTH_TOKEN}"
      ],
      "env": {
        "MODUSIGN_AUTH_TOKEN": "BASIC YOUR_ENCODED_AUTH_STRING"
      }
    }
  }
}

🚧
YOUR_ENCODED_AUTH_STRING을 위에서 생성한 Base64 인코딩된 문자열로 교체해주세요.

연동 테스트하기

설정 완료 후 다음 단계를 통해 MCP 서버 연결을 확인할 수 있습니다:

1단계: 애플리케이션 재시작

설정 파일 변경 후 해당 AI 도구를 완전히 재시작하세요.

2단계: 새 채팅 시작

AI 어시스턴트와 새로운 대화를 시작합니다.

3단계: 연동 확인

아래 테스트 질문으로 연동 상태를 확인하세요.

문제 해결

연결이 안 될 때

다음 사항들을 순서대로 확인해보세요:

설정 파일 경로: 운영체제별 정확한 경로에 파일이 위치하는지 확인
JSON 구문: 설정 파일의 JSON 형식이 올바른지 검증
애플리케이션 재시작: 설정 후 해당 AI 도구를 완전히 재시작
네트워크 접근: https://developers.modusign.co.kr/mcp에 접근 가능한지 확인
권한 설정: API 키가 올바르게 설정되었는지 확인

인증 오류가 발생할 때

API 접근 시 인증 오류가 발생하는 경우:

API 키 확인: 모두싸인에서 발근한 API 키가 유효한지 확인
인코딩 되었는지: 모두싸인의 권한 인증 시 사용자 이메일과 발급받은 API KEY를 콜론(:)으로 붙여 구성합니다.
헤더 형식: Authorization 헤더 형식이 BASIC MODUSIGN_EMAIL:MODUSIGN_API_KEY 형태인지 확인
환경변수: 환경변수에 API 키가 올바르게 설정되었는지 확인
권한 범위: API 키에 필요한 권한이 부여되었는지 확인

성능 이슈가 있을 때

MCP 서버 응답이 느리거나 타임아웃이 발생하는 경우:

네트워크 상태: 인터넷 연결 상태 확인
서버 상태: 모두싸인 서비스 상태 페이지 확인
요청 크기: 너무 큰 데이터를 요청하지 않는지 확인
동시 요청: 동시에 너무 많은 요청을 보내지 않는지 확인

추가 지원

💡
기술적 문제가 지속되거나 추가적인 도움이 필요하시면 다음을 통해 지원받으실 수 있습니다:

기술 문서: 모두싸인 개발자 문서

API 레퍼런스: API 문서

기술 지원: 모두싸인 기술 지원팀 문의

참고: 이 가이드는 모두싸인 MCP 서버의 기본 설정 방법을 다룹니다 추가 적인 문의는 기술 지원팀에 문의해주세요.

모두싸인의 MCP 활용하기

모두싸인 MCP 서버 연동 가이드

MCP란 무엇인가요?

설정 방법

중요: 인증이 필요한 API 사용 시 쿼리 파라미터나 헤더를 통해 인증 정보를 전달해야 합니다.

기본 설정

MCP 권한 설정 (인증 필요시)

연동 테스트하기

추천 테스트 질문들

문제 해결

추가 지원

기술적 문제가 지속되거나 추가적인 도움이 필요하시면 다음을 통해 지원받으실 수 있습니다: