DeepNeedle Insight
DeepNeedle Insight를 MCP로 연결하면, 쓰던 AI 도구에서 대화하듯 우리 사이트의 추천 성과를 조회합니다. 이 주소는 그 연결에 쓰는 데이터 조회 서버입니다.
두 가지 중 하나를 고르면 됩니다. 아래 명령은 Claude Code 기준입니다.
Claude Code가 이미 설치돼 있으면 건너뛰세요. 터미널에서 claude --version을 입력해 버전 번호가 나오면 설치된 것입니다.
macOS, Linux (터미널)
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
claude를 실행합니다. 브라우저가 열리면 Claude 계정으로 로그인합니다.Claude Code는 Claude 유료 요금제(Pro, Max, Team, Enterprise 등) 계정이 있어야 쓸 수 있습니다. 무료 요금제로는 쓸 수 없습니다. 다른 설치 방법(Homebrew, WinGet 등)과 문제 해결은 Claude Code 설치 안내를 참고하세요.
claude mcp add --transport http deepneedle-insight https://insight.deepneedle.com/mcp
claude를 실행합니다./mcp를 입력하고 Enter를 누릅니다. 연결된 서버 목록이 나오고, deepneedle-insight에는 인증이 필요하다는 표시가 붙어 있습니다.브라우저가 열리지 않으면 터미널에 나온 주소를 복사해 브라우저에 붙여 넣으세요. 메뉴 이름은 Claude Code 버전에 따라 조금 다를 수 있습니다.
토큰을 발급받거나 복사할 필요가 없습니다. 연결은 자동으로 갱신되며, 30일 동안 쓰지 않으면 같은 방법으로 다시 인증하면 됩니다. 로그인 연결은 담당자가 사이트에 이 서비스를 켜 둔 경우에만 됩니다. 허용을 눌러도 연결되지 않으면 담당자에게 문의해 주세요.
claude mcp add --transport http deepneedle-insight https://insight.deepneedle.com/mcp \
--header "Authorization: Bearer <토큰>"
MCP(Model Context Protocol)의 HTTP 방식을 지원하는 다른 도구에도 같은 주소로 연결할 수 있습니다. 로그인(OAuth)을 지원하면 방법 1, 요청 헤더를 넣을 수 있으면 방법 2를 씁니다. Gemini와 ChatGPT는 아래에 따로 안내합니다. claude.ai 웹·앱의 커넥터 연결은 아직 확인 중입니다.
주소는 같습니다. 로그인하면 DeepNeedle 어드민 계정으로, 토큰을 쓰면 어드민에서 발급받은 토큰으로 연결됩니다.
Gemini Code Assist Standard·Enterprise 라이선스나 유료 Gemini API 키로 Gemini CLI를 쓰는 경우입니다. 개인 요금제(Google AI Pro·Ultra)를 쓰면 아래 Antigravity CLI를 보세요.
gemini mcp add --transport http -s user deepneedle-insight https://insight.deepneedle.com/mcp
gemini를 실행하고, 입력창에 /mcp auth deepneedle-insight를 입력합니다.토큰으로 연결하려면 1번에서 아래처럼 등록하고 2·3번은 건너뜁니다.
gemini mcp add --transport http -s user \
-H "Authorization: Bearer <토큰>" deepneedle-insight https://insight.deepneedle.com/mcp
설정 파일 ~/.gemini/config/mcp_config.json에 아래 내용을 넣고 Antigravity CLI를 다시 시작합니다. 파일에 다른 서버가 이미 있으면 mcpServers 안에 deepneedle-insight 항목만 추가합니다.
{
"mcpServers": {
"deepneedle-insight": {
"serverUrl": "https://insight.deepneedle.com/mcp",
"headers": { "Authorization": "Bearer <토큰>" }
}
}
}
지금은 토큰으로 연결하는 방법만 안내합니다. 로그인으로 연결하는 방법은 확인 중입니다.
https://insight.deepneedle.com/mcp를 넣습니다. 인증은 OAuth를 고르고 Create as a plugin을 누릅니다.ChatGPT 유료 요금제에서만 직접 서버를 추가할 수 있고, 회사 워크스페이스는 관리자가 이 기능을 막아 둘 수 있습니다. 토큰으로는 연결할 수 없습니다. 아직 연결을 확인하는 중이라 되지 않을 수 있습니다. 메뉴 이름은 ChatGPT 화면에 따라 조금 다를 수 있습니다.
gemini.google.com의 맞춤 앱 연결은 아직 일부 개인 계정에만 열려 있어 안내하지 않습니다.
| MCP | https://insight.deepneedle.com/mcp |
|---|---|
| REST | https://insight.deepneedle.com/api/tools 도구 목록, https://insight.deepneedle.com/api/tools/<도구> 실행 |
| 인증 | 모든 요청에 Authorization: Bearer <토큰> 헤더. 로그인으로 연결하면 도구가 이 헤더를 알아서 붙입니다 |
| OAuth | https://insight.deepneedle.com/.well-known/oauth-authorization-server |