처음 연동하는 분을 위한 순서입니다. 토큰 하나로 REST API·CLI 를 쓰고, AI 커넥터는 로그인만으로 연결합니다. 기본 주소는 https://inventips.net 입니다.
1. 토큰 발급
- 웹에 로그인합니다. 2단계 인증을 켠 계정은 인증 코드까지 넣어야 발급됩니다.
- 마이페이지 → 보안/개인정보 → CLI 토큰으로 갑니다.
- 이름(예:
정리봇 노트북), 유효 기간(30일·90일·1년·만료 없음(봇용)), 권한(읽기+쓰기(크레딧 사용) 또는 읽기 전용)을 고르고 발급을 누릅니다. - 한 번만 보이는
itp_로 시작하는 토큰을 복사합니다. 다시 볼 수 없습니다. - 터미널에 환경 변수로 넣습니다.
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 이상이 필요합니다.
- CLI 파일을 받습니다.
- 토큰을 저장합니다(
~/.inventips/config.json). 환경 변수INVENTIPS_TOKEN이 있으면 이 단계는 건너뛰어도 됩니다. 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 는 한 줄이면 됩니다.
- 터미널에서 서버를 추가합니다.
- Claude Code 에서
/mcp→inventips를 고르면 브라우저 로그인이 뜹니다. - 인벤팁스 로그인(2단계 인증) 뒤 허용 화면에서 필요한 범위(내 명세서 읽기·작업 실행)를 체크하고 허용합니다.
- "드론 배터리 교체 장치 한국 선행특허 찾아 줘" 처럼 물어 도구가 불리는지 확인합니다.
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 커넥터에 있습니다.