Claude Desktop과 Claude Code 설정이 다른가요?

기본 원리는 같습니다. mcpServers 항목에 싸인딜 서버를 등록하면 됩니다. 다만 설정 파일 위치와 형식은 클라이언트마다 다를 수 있으니, 각 도구의 공식 안내를 함께 참고하세요.

HTTP 직접 연결과 mcp-remote 중 무엇을 써야 하나요?

원격 HTTP 연결을 지원하는 클라이언트라면 직접 연결이 더 간단합니다. 로컬 stdio 방식만 지원하는 클라이언트는 mcp-remote 브리지로 원격 서버에 연결하세요. 백엔드는 동일합니다.

연결만 하면 곧바로 계약이 발송되나요?

아닙니다. 발송 계열 tool은 dry-run 미리보기와 confirmation_token 승인을 거쳐야만 실제로 실행됩니다. 이 두 단계는 서버단에서 강제되어 클라이언트가 끌 수 없습니다.

API 키를 코드에 직접 적어도 되나요?

권장하지 않습니다. 키는 서버 측 환경변수로 관리하고 공개 저장소나 클라이언트에 노출하지 마세요. 노출이 의심되면 대시보드에서 키를 재발급하는 것이 안전합니다.

OAuth로 로그인 연결할 수는 없나요?

현재는 API 키(Bearer) 인증을 지원합니다. OAuth 2.1 동적 인증은 추진 중이며, 제공 시점과 방식은 개발자 안내 페이지에서 업데이트됩니다.

Claude에 싸인딜 MCP 연결하기: 단계별 가이드

Claude에게 "300만 원 차용증을 써서 010-1234-5678로 보내줘"라고 말하면, 연결된 도구가 초안을 잡고 발송 미리보기까지 만들어 줍니다. 이를 가능하게 하는 것이 MCP(Model Context Protocol) 연결입니다. 이 글은 Claude Desktop·Code에 싸인딜 MCP 서버를 붙이는 과정을 단계별로 안내합니다.

연결 전 준비물

시작 전 다음 세 가지를 확인하세요.

싸인딜 계정: 가입하면 1회성으로 평생 무료 100건이 제공되어, 연결 후 곧바로 흐름을 시험해 볼 수 있습니다.
MCP 호환 클라이언트: Claude Desktop 또는 Claude Code 등 MCP를 지원하는 도구.
설정 파일 접근: 클라이언트의 설정 파일(예: claude_desktop_config.json)을 열어 수정할 수 있어야 합니다.

1단계: API 키 발급받기

싸인딜 대시보드에서 API 키를 발급합니다. live 키와 test 키를 구분해 발급할 수 있으니, 처음에는 부담 없이 시험할 수 있는 키부터 사용하세요.

발급한 키는 서버 측 환경변수로 보관하고, 공개 저장소나 클라이언트에 노출하지 않는 것이 안전합니다. 인증은 현재 API 키(Bearer) 방식을 지원하며, OAuth 2.1 동적 인증은 추진 중입니다.

2단계: Claude에 mcpServers 등록

설정 파일의 mcpServers 항목에 싸인딜 서버를 추가합니다. 원격 서버를 Streamable HTTP로 직접 연결하는 방식이 가장 간단합니다.

HTTP로 직접 연결하는 예시

{ "mcpServers": { "signdeal": { "type": "http", "url": "https://mcp.signdeal.kr", "headers": { "Authorization": "Bearer 발급받은-API-키" } } } }

로컬 stdio 브리지가 필요한 클라이언트라면 mcp-remote로 원격 서버를 연결할 수 있습니다.

mcp-remote 브리지를 쓰는 예시

{ "mcpServers": { "signdeal": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.signdeal.kr"], "env": { "SIGNDEAL_API_KEY": "발급받은-API-키" } } } }

저장한 뒤 Claude 클라이언트를 다시 시작하면 싸인딜 tool들이 인식되어, 양식 조회·초안 생성·서명자 추가·발송 미리보기를 대화로 호출할 수 있습니다.

3단계: 첫 호출은 dry-run으로

연결을 확인하는 가장 안전한 방법은 발송을 dry-run(미리보기)으로 먼저 돌려 보는 것입니다. 싸인딜의 발송 계열 tool은 두 단계 안전 흐름을 서버단에서 강제합니다.

미리보기: dry_run=true로 호출하면 실제 발송 없이 수신자·채널·예상 결제가와 confirmation_token이 반환됩니다.
승인 게이트: 이 토큰은 5분·1회용이며 계약 내용에 바인딩됩니다. 내용이 바뀌면 무효가 되어 다시 미리보기를 받아야 합니다.
실제 발송: 토큰을 다시 전달해야 비로소 발송이 실행되고, 이때 본인확인·타임스탬프·감사추적이 함께 적용됩니다.

이 게이트는 클라이언트가 끌 수 없어, AI나 코드의 실수로 계약이 잘못 나가는 일을 줄여 줍니다.

연결이 안 될 때 점검 목록

tool이 보이지 않거나 호출이 실패하면 아래를 차례로 확인하세요.

키 형식: Authorization 헤더가 Bearer 접두어를 포함하는지.
재시작: 설정 저장 후 클라이언트를 완전히 종료했다가 다시 열었는지.
JSON 문법: 쉼표·따옴표 누락 등 설정 파일의 문법 오류가 없는지.
브리지 경로: mcp-remote 방식이라면 npx 실행 환경이 준비되어 있는지.

참고로 싸인딜의 실제 발송·결제 등 일부 기능은 준비·연동 단계에 있습니다. 연결과 dry-run 미리보기로 흐름을 먼저 확인하고, 정식 발송 범위는 확장되는 방향으로 보시는 것이 정확합니다. 더 자세한 tool 목록과 REST·웹훅 사용법은 개발자 안내에서 확인할 수 있습니다.