helpdashHelpdash는 Model Context Protocol(MCP) 서버를 제공합니다. 그래서 AI 어시스턴트가 여러분이 티켓을 채팅 창에 복사해 붙여 넣는 대신 워크스페이스 안에서 바로 일할 수 있습니다. "오늘 SLA를 어기는 티켓이 뭐야?" 또는 "인수인계용으로 이 대화를 요약해줘"라고 하면 어시스턴트가 Helpdash에 직접 질의합니다.
이 글에서는 커넥터가 무엇을 제공하는지, 어떻게 연결하는지, 그리고 — 두 번 읽을 값어치가 있는 부분 — 무엇을 하도록 허용되지 않는지를 다룹니다.
커넥터가 제공하는 것
서버에는 46개의 도구, 미리 만들어둔 프롬프트 4개, 그리고 도구가 받아들이는 모든 열거값을 나열한 리소스 하나가 들어 있습니다. 도구는 티켓, 실시간 채팅, 지식 베이스, 저장된 답변, 프로젝트와 팀원, 대시보드, CSAT, 자동화 규칙, 웹훅, 설정, 활동 로그, 결제까지 아우릅니다.
읽기와 쓰기는 언제나 별개의 도구입니다. method 매개변수를 가진 만능 api_request 도구는
없습니다. 티켓 검색과 티켓 수정은 권한이 다른 서로 다른 도구이므로, 읽기 권한만 받은 어시스턴트가
인자를 바꿔 무언가를 변경할 수는 없습니다.
네 개의 프롬프트는 미리 써둘 만한 작업 흐름입니다.
- 티켓 분류하기 — 우선순위, 분류, 담당자를 제안합니다. 아무것도 바꾸지 않습니다.
- 고객 답장 초안 쓰기 — 지식 베이스와 저장된 답변으로 문안을 만듭니다. 보낼 수는 없고, 답장은 여러분이 검토하도록 돌아옵니다.
- 대화 요약하기 — 긴 티켓이나 채팅 기록을 교대 인수인계용으로 압축합니다.
- 주간 지원 리포트 — 건수, SLA, CSAT, 그리고 주의가 필요한 것들.
클라이언트 연결하기
**설정 → AI 커넥터(MCP)**를 열고 토큰을 발급하세요. 나중에 알아볼 수 있는 이름을 붙이고, 첫 토큰에서는 쓰기 스위치를 전부 꺼둔 채로 키를 복사하세요. 키는 정확히 한 번만 표시됩니다.
그다음 등록합니다. Claude Code라면:
claude mcp add --transport http helpdash https://your-workspace.helpdash.io/mcp \
--header "Authorization: Bearer hd_mcp_..."
.mcp.json을 읽는 클라이언트라면:
{
"mcpServers": {
"helpdash": {
"type": "http",
"url": "https://your-workspace.helpdash.io/mcp",
"headers": { "Authorization": "Bearer hd_mcp_..." }
}
}
}
두 코드 조각 모두 여러분의 워크스페이스 주소가 채워진 채로, 토큰이 나타나는 바로 그 화면에서 만들어집니다.
브라우저 로그인을 선호하는 클라이언트는 정적 토큰 대신 OAuth 2.1을 쓸 수 있습니다. 서버는 표준 디스커버리 문서를 게시하고, PKCE와 동적 클라이언트 등록을 지원하며, 어떤 범위를 요청하는지 정확히 나열한 동의 화면을 보여줍니다. 복사할 토큰도, 디스크에 저장할 키도 없습니다.
할 수 없는 일
커넥터는 더 느슨한 두 번째 API가 아닙니다. 모든 호출은 사람의 요청과 똑같은 네 개의 관문을 지납니다.
여러분으로서 행동합니다. 토큰은 그것을 발급한 운영자에게 묶입니다. 그 사람의 역할과 권한을 그대로 물려받으므로, 여러분이 앱에서 티켓을 열 수 없다면 여러분의 토큰을 든 어시스턴트도 열 수 없습니다. 그리고 하나의 워크스페이스에 묶입니다. 다른 테넌트의 데이터에 닿는 인자는 없습니다.
달리 말하지 않는 한 읽기 전용입니다. 스위치를 전부 끈 새 토큰은 검색하고, 읽고, 리포트를 낼 수 있습니다. 그 이상은 못 합니다. 쓰기 권한은 영역별로 부여합니다 — 티켓 수정, 실시간 채팅 답장, 지식 베이스 편집, 프로젝트 관리, 팀원 초대, 설정 변경, 자동화 규칙 변경 — 그리고 여러분이 체크한 것만입니다. 읽기는 언제나 포함됩니다. 쓸 수는 있지만 읽지 못하는 어시스턴트는 쓸모가 없으니까요.
쓰기 도구는 먼저 묻습니다. 데이터를 바꾸는 도구는 모두 파괴적이라고 표시되어 있어서, 잘 만든 클라이언트는 조용히 실행하는 대신 호출마다 여러분에게 확인합니다. 고객에게 닿는 도구는 자기 설명에 그 사실을 밝힙니다. 실시간 채팅 메시지는 즉시 전달되고 회수할 수 없으며, 티켓 댓글은 기본이 내부 메모라서 실수로 고객에게 가지 않습니다.
비밀은 서버에 남습니다. 커넥터로 설정을 읽으면 연동 자격 증명은 가려진 채 돌아옵니다. 그걸 벗기는 인자는 없습니다.
고객이 쓴 글은 울타리 안에 둡니다. 티켓 설명, 댓글, 채팅 기록은 다른 사람들이 쓴 것이고, 지원 받은편지함은 바로 누군가 그것을 읽는 AI를 겨냥해 지시를 심어보려 할 만한 자리입니다. Helpdash는 그런 글을 명시적인 신뢰할 수 없는 콘텐츠 블록으로 감싸고, 서버 자체의 지침에서 모델에게 그 안의 어떤 것도 명령이 아니라고 알립니다.
모든 것이 기록됩니다. 호출마다 운영자, 도구, 결과가 워크스페이스의 나머지와 같은 감사 로그에 남습니다. 언젠가 "어시스턴트가 화요일에 실제로 뭘 했지?"에 답해야 한다면 기록이 거기 있습니다.
철회는 즉시 적용됩니다. 설정에서 토큰을 지우면 어시스턴트의 바로 다음 요청부터 막힙니다. 우리는 키의 SHA-256 해시만 저장하므로 대신 복구해 드릴 수 없습니다. 잃어버렸다면 새로 발급하세요.
토큰을 더 조이기
알아둘 만한 선택 설정이 두 가지 있습니다. 토큰에는 만료일을 붙일 수 있는데, 짧은 실험이 스스로 정리되게 하는 가장 쉬운 방법입니다. 그리고 IP 허용 목록도 붙일 수 있어, 어느 한 서버용으로 만든 토큰을 다른 곳에서 쓸 수 없게 합니다. 둘 다 같은 생성 화면에 있습니다.
합리적인 첫 토큰
쓰기 범위 없이 하나를 발급하고 어시스턴트에게 읽기 전용으로 일주일을 주세요. SLA 위험을 찾고, 어수선한 대화를 요약하고, 여러분이 직접 보낼 답장 초안을 쓰게 해보세요. 노출 없이 대부분의 가치를 얻을 수 있습니다. 어떤 쓰기 범위가 정말 필요한지 알게 되면 그것만 담은 두 번째 토큰을 발급하세요. 기존 토큰을 넓히는 건 의도적으로 불가능합니다.
위의 모든 서술은 오늘 제공되는 동작을 설명한 것입니다. 커넥터는 모든 Helpdash 워크스페이스에서 쓸 수 있습니다.