Docs개발자 가이드

개발자 가이드

자체 서비스에 FindIP를 임베드하거나, 커스텀 LLM 환경에 MCP 서버를 직접 호스팅하시려는 개발자를 위한 가이드입니다. 일반 사용자로 Claude·ChatGPT·Gemini 등에 연결하시려면 AI 연결 가이드를 먼저 확인하세요.

자체 서비스에 REST API 임베드

MCP를 지원하지 않는 환경(웹앱, 모바일, 사내 시스템)에 검색 기능을 직접 내장할 때 사용합니다. HTTP 헤더에 API 키만 넣으면 즉시 사용할 수 있습니다.

1. API 키 발급

대시보드에서 무료로 발급받습니다.

2. 엔드포인트 명세

시맨틱 검색·통계·인증 엔드포인트 명세.

cURL

# 시맨틱 검색 호출 예시
curl -X POST https://api.findip.ai/api/v1/search/semantic \
  -H "X-API-Key: psk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "리튬 덴드라이트 성장을 억제하는 고체 전해질 기술",
    "top_k": 5
  }'

커스텀 MCP 호스팅

FindIP MCP 서버는 Node.js 기반이며 두 가지 호스팅 방식을 지원합니다.

NPM 패키지 (stdio): 로컬 데스크탑 앱 설정 파일에 CLI 명령을 직접 주입합니다. API 키가 환경 변수로 필요합니다.
SSE / Streamable HTTP 엔드포인트: 웹 서비스나 분산 환경에서 여러 에이전트가 단일 MCP 서버를 공유할 때 사용합니다. 인증은 OAuth 또는 API 키.

NPM 패키지 사용 (stdio)

# 글로벌 설치
npm install -g @findip/patent-search-mcp

# 직접 실행
FINDIP_API_KEY=psk_live_... npx @findip/patent-search-mcp

Claude Desktop 커스텀 설정

{
  "mcpServers": {
    "findip-mcp": {
      "command": "npx",
      "args": ["-y", "@findip/patent-search-mcp"],
      "env": {
        "FINDIP_API_KEY": "psk_live_..."
      }
    }
  }
}

참고

현재 @findip/patent-search-mcp NPM 패키지는 비공개 베타입니다. 정식 출시 전까지는 원격 SSE URL 방식(https://api.findip.ai/mcp) 사용을 권장합니다.

참고 자료