문서 목록

개발자·연동

연동 개요

AI 커넥터(MCP), CLI, REST API — 무엇을 고르고 권한이 어떻게 다른지.

인벤팁스를 화면 밖에서 쓰는 길은 세 가지입니다. 모두 같은 개인 토큰 체계를 쓰고, 권한으로 갈립니다. 토큰 발급부터 첫 호출까지는 빠른 시작을 따라 하세요.

AI 커넥터 (MCP)CLIREST API
누가 쓰나Claude·ChatGPT·Claude Code·Cursor 사용자터미널·외부 에이전트직접 연동하는 개발자
연결커넥터 설정에 URL 입력 → 인벤팁스 로그인·허용마이페이지에서 토큰 발급같음
할 수 있는 것특허·상표·디자인 조회, (허락 시) 내 명세서 읽기, (작업 실행 허락 시) 선행조사·보고서·생성·후속출원·OA(거절결정 대응 포함)·심사 예측·FTO·특허 평가·번역·우선심사·사건·기한 조회. 파일을 주고받는 일과 고객 발송은 제외웹의 거의 모든 기능 + 파일 올리기·내려받기CLI 와 같음
바꾸는 작업「작업 실행」을 허락했을 때만있음(쓰기 권한 토큰)있음
크레딧작업 도구만(먼저 예상치를 보여 줌)생성·분석·보고서같음
문서AI 커넥터CLIREST 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, CLI notify 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 토큰 공개