인벤팁스를 화면 밖에서 쓰는 길은 세 가지입니다. 모두 같은 개인 토큰 체계를 쓰고, 권한으로 갈립니다. 토큰 발급부터 첫 호출까지는 빠른 시작을 따라 하세요.
| AI 커넥터 (MCP) | CLI | REST API | |
|---|---|---|---|
| 누가 쓰나 | Claude·ChatGPT·Claude Code·Cursor 사용자 | 터미널·외부 에이전트 | 직접 연동하는 개발자 |
| 연결 | 커넥터 설정에 URL 입력 → 인벤팁스 로그인·허용 | 마이페이지에서 토큰 발급 | 같음 |
| 할 수 있는 것 | 특허·상표·디자인 조회, (허락 시) 내 명세서 읽기, (작업 실행 허락 시) 선행조사·보고서·생성·후속출원·OA(거절결정 대응 포함)·심사 예측·FTO·특허 평가·번역·우선심사·사건·기한 조회. 파일을 주고받는 일과 고객 발송은 제외 | 웹의 거의 모든 기능 + 파일 올리기·내려받기 | CLI 와 같음 |
| 바꾸는 작업 | 「작업 실행」을 허락했을 때만 | 있음(쓰기 권한 토큰) | 있음 |
| 크레딧 | 작업 도구만(먼저 예상치를 보여 줌) | 생성·분석·보고서 | 같음 |
| 문서 | AI 커넥터 | CLI | REST API |
권한 한눈에 보기
| 토큰 권한 | 생기는 곳 | 열리는 것 |
|---|---|---|
| 공개 조회 | 커넥터 연결 | MCP 특허·상표·디자인 도구 |
| 명세서 읽기(커넥터) | 커넥터 연결 때 "내 명세서 읽기" 체크 | MCP 명세서 도구(목록·본문·작업 상태). REST API 는 열리지 않음 |
| 읽기 | CLI 토큰(읽기 전용 또는 읽기+쓰기) | REST API 조회·내보내기, MCP 특허·상표·명세서 도구와 조회용 작업 도구(작업 상태·보고서·사건) |
| 쓰기 | CLI 토큰(읽기+쓰기), 커넥터 「작업 실행」 | 생성·수정·보고서·OA·우선심사·경쟁기업·사건 기록, MCP 작업 도구 |
공통 규칙
- 승인된 계정만 토큰을 만들고 쓸 수 있습니다. 승인이 취소되면 5분 안에 모든 토큰이 끊깁니다.
- 2단계 인증을 켠 계정은 인증을 마친 로그인 상태에서만 토큰 발급·커넥터 연결이 됩니다.
- 토큰은 본인 명세서만 봅니다. 다른 사람의 문서 id 를 넣으면 없는 문서처럼 404 가 납니다. 사무소(팀) 사건은 웹과 같은 권한으로 봅니다 — 대표·관리자는 사무소 사건 전부, 직원·열람 멤버는 담당으로 지정된 사건과 그 작업만. 사무소 사건에 묶인 작업(명세서·OA·우선심사·조사 보고서)은 그 사건을 볼 수 있는 사람이 조회·내려받기만 할 수 있고, 고치거나 AI 작업을 돌리는 것은 만든 사람만 합니다.
- 토큰으로 새 토큰을 만들 수 없습니다. 유출된 토큰이 스스로 늘어나는 것을 막기 위해서입니다.
- 유효 토큰은 계정당 10개까지입니다. 커넥터를 여러 번 다시 연결해 상한에 닿으면 가장 오래된 커넥터 토큰이 자동 폐기됩니다.
- 요청 제한은 토큰당 분당 120회, 계정 합계 분당 300회, 생성·분석 시작과 파일 내보내기 같은 무거운 요청은 토큰당 분당 10회입니다. 넘으면
429와Retry-After를 돌려줍니다. 자세한 목록은 REST API의 「요청 한도」에 있습니다. - 모든 호출은 누가·어떤 토큰으로·무엇을 불렀는지 기록됩니다. 요청 본문이나 도구 인자(발명 내용일 수 있음)는 기록하지 않습니다. 토큰으로 바꾼 명세서·사건에는 토큰 이름이 남아 웹 경고와 편집 이력에 "누가" 가 보입니다 — 봇마다 토큰을 따로 발급하세요.
- 쓰기 요청에
Idempotency-Key헤더(8~200자)를 붙이면 같은 키로 다시 보낸 요청에 첫 응답을 그대로 돌려줍니다(24시간). 네트워크 오류로 다시 보내도 크레딧이 두 번 나가지 않습니다. CLI 는 자동으로 붙입니다. - 토큰에 알림 주소를 등록하면(
PUT /api/v1/me/notify, CLInotify set) 그 토큰이 시작한 작업이 끝나거나·실패하거나·확인 질문에서 멈출 때 서버가 그 주소로 POST 합니다(X-Inventips-Signature: sha256=HMAC). - 마이페이지 → 보안 → CLI 토큰에서 모든 토큰(커넥터 포함)의 마지막 사용 시각을 보고 폐기할 수 있습니다.
변경 이력
연동 기능의 큰 변화만 적습니다. 서비스 전체 이력은 업데이트 이력에 있습니다.
| 날짜 | 변화 |
|---|---|
| 2026-11-20 | 분할출원 청구항 — 원출원에서 청구하지 않은 실시예 후보 찾기(근거 인용 원문 대조)·고른 후보로 한번에 생성, 생성 루프 안의 원출원 근거·중복 검사(API /drafts/:id/divisional/*, CLI drafts divisional-*, MCP find_divisional_candidates 등, 웹 분할 명세서 화면). 가출원(임시 출원) 옵션을 한번에 생성에서도 켤 수 있게(API provisional, CLI generate --provisional, MCP start_draft_generation 의 provisional) |
| 2026-11-19 | 웹에만 있던 기능을 API·CLI·MCP 로 — 후속출원(분할·계속·우선권 주장·명세서 가져오기: POST /drafts 의 source, CLI drafts create --kind), 거절결정 대응 절차(재심사·심판: oa analyze --procedure, 조회의 noticeStage), 심사 예측(/exam-predict), FTO(/fto), 특허 평가(/valuations), 명세서 번역(/translations), 기한 조회(/docket), 해외 출원 기한 계산(/overseas/deadlines). MCP 에 사건 만들기·수정, 동의 링크, 위임장 조회, 우선심사 건, 디자인 검색 도구 추가. 한번에 생성이 후속출원 지침을 프롬프트에 넣는다 |
| 2026-11-03 | 사건함(파일 자동 분류)·다음 할 일 제안과 실행 — API /matters/:id/files·/plan·/run, CLI matter files·plan·run. 사건 산출물 한 번에 받기(CLI matter export). 사무소 사건의 직원 작업을 대표·관리자·담당자가 열람·내려받기 |
| 2026-10-24 | 에이전트용 CLI·API 확대 — 명세서 만들기·한번에 생성(간단 모드 포함), 보고서·경쟁기업·우선심사·OA, 위임장, 도면 교체, 고객 출원 동의 링크, 확정 대기, 선행조사 기준일·제외 문헌 |
| 2026-10-19 | 원격 MCP 커넥터와 개인 API 토큰 공개 |