문서 목록

개발자·연동

빠른 시작

토큰 발급부터 첫 API 호출, 첫 CLI 명령, AI 커넥터 연결까지 각각 5단계 안에.

처음 연동하는 분을 위한 순서입니다. 토큰 하나로 REST API·CLI 를 쓰고, AI 커넥터는 로그인만으로 연결합니다. 기본 주소는 https://inventips.net 입니다.

1. 토큰 발급

  1. 웹에 로그인합니다. 2단계 인증을 켠 계정은 인증 코드까지 넣어야 발급됩니다.
  2. 마이페이지 → 보안/개인정보 → CLI 토큰으로 갑니다.
  3. 이름(예: 정리봇 노트북), 유효 기간(30일·90일·1년·만료 없음(봇용)), 권한(읽기+쓰기(크레딧 사용) 또는 읽기 전용)을 고르고 발급을 누릅니다.
  4. 한 번만 보이는 itp_ 로 시작하는 토큰을 복사합니다. 다시 볼 수 없습니다.
  5. 터미널에 환경 변수로 넣습니다.
export INVENTIPS_TOKEN=itp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

조회만 하는 프로그램에는 읽기 전용 토큰을 주세요. 토큰은 비밀번호와 같습니다 — 저장소·채팅·로그에 남기지 마세요.

2. 첫 API 호출

GET /api/v1/me 로 토큰이 맞는지, 잔여 크레딧과 권한을 확인합니다. 크레딧은 들지 않습니다.

curl -s https://inventips.net/api/v1/me \
  -H "Authorization: Bearer $INVENTIPS_TOKEN"
import os
import requests

BASE = "https://inventips.net/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['INVENTIPS_TOKEN']}"}

r = requests.get(f"{BASE}/me", headers=HEADERS, timeout=30)
r.raise_for_status()
me = r.json()
print(me["credits"], me["token"]["scopes"])
// Node.js 18+ (내장 fetch). 파일 이름을 me.mjs 로 저장해 실행합니다.
const BASE = 'https://inventips.net/api/v1';
const res = await fetch(`${BASE}/me`, {
  headers: { Authorization: `Bearer ${process.env.INVENTIPS_TOKEN}` },
});
if (!res.ok) throw new Error(`${res.status} ${(await res.json()).error}`);
const me = await res.json();
console.log(me.credits, me.token.scopes);

응답 예시입니다.

{
  "userId": "00000000-0000-0000-0000-000000000000",
  "name": "홍길동",
  "firmName": "예시특허사무소",
  "tier": "PRO",
  "credits": 120,
  "isBenchmark": false,
  "token": {
    "id": "11111111-1111-1111-1111-111111111111",
    "name": "정리봇 노트북",
    "scopes": ["read", "write"],
    "expiresAt": "2027-02-10T00:00:00.000Z",
    "notifyUrl": null
  }
}

401 이면 토큰을 잘못 넣었거나 만료·폐기된 것입니다. 다음으로 GET /api/v1/drafts?limit=5 로 내 명세서 목록을 불러 보세요. 전체 엔드포인트는 REST API에 있습니다.

3. 첫 CLI 명령

Node.js 18 이상이 필요합니다.

  1. CLI 파일을 받습니다.
  2. 토큰을 저장합니다(~/.inventips/config.json). 환경 변수 INVENTIPS_TOKEN 이 있으면 이 단계는 건너뛰어도 됩니다.
  3. whoami 로 확인하고 명세서 목록을 봅니다.
curl -o inventips.mjs https://inventips.net/cli/inventips.mjs
node inventips.mjs login --token "$INVENTIPS_TOKEN"
node inventips.mjs whoami
node inventips.mjs drafts list --limit 5

에이전트가 결과를 읽게 하려면 --json 을 붙입니다. 크레딧이 드는 명령은 예상 크레딧을 먼저 보여 주고 확인을 묻습니다. 명령 전체는 CLI를 보세요.

4. AI 커넥터(MCP) 연결

Claude Code 는 한 줄이면 됩니다.

  1. 터미널에서 서버를 추가합니다.
  2. Claude Code 에서 /mcp → inventips 를 고르면 브라우저 로그인이 뜹니다.
  3. 인벤팁스 로그인(2단계 인증) 뒤 허용 화면에서 필요한 범위(내 명세서 읽기·작업 실행)를 체크하고 허용합니다.
  4. "드론 배터리 교체 장치 한국 선행특허 찾아 줘" 처럼 물어 도구가 불리는지 확인합니다.
claude mcp add --transport http inventips https://inventips.net/api/mcp

Claude 웹·데스크톱은 설정 → 커넥터 → 커스텀 커넥터 추가에 https://inventips.net/api/mcp 를 넣습니다. 브라우저 로그인을 할 수 없는 에이전트는 CLI 토큰을 헤더로 넣습니다.

claude mcp add --transport http inventips https://inventips.net/api/mcp \
  --header "Authorization: Bearer $INVENTIPS_TOKEN"

ChatGPT·Cursor 연결과 도구 목록은 AI 커넥터에 있습니다.

다음 단계

  • 권한과 공통 규칙(요청 한도·중복 방지·알림): 연동 개요
  • 오래 걸리는 작업은 202 {taskId} 를 받아 GET /api/v1/tasks/:taskId 로 확인하거나, 알림 주소를 등록해 끝날 때 받습니다(REST API).
  • 크레딧이 드는 요청은 ?dryRun=1 로 예상 크레딧부터 확인하세요.