본문으로 건너뛰기
제품요금제문서블로그로그인English시작하기

도구 목록과 CLI 명령

AiNecto MCP 서버 하나가 워크스페이스·문서 도구와 ERD·다이어그램·Markdown 도구를 함께 제공합니다. 이 문서는 Agent가 받는 도구의 종류와 AiNecto CLI 명령을 정리합니다. 연결은 사용 중인 Agent 연결하기, 연결 문제는 CLI와 연결 문제 해결을 참고하세요.

도구 이름 읽는 법​

Agent는 연결할 때 정한 서버 이름을 도구 이름 앞에 붙입니다. 서버 이름을 ainecto로 등록했다면 Claude Code에서는 mcp__ainecto__list_projects처럼 보입니다. 정확한 목록은 Agent의 MCP 도구 화면에서 확인합니다. 서버가 도구를 더하거나 바꾸면 그 화면이 먼저 바뀝니다.

워크스페이스와 문서​

워크스페이스, 프로젝트, 폴더, 문서, 버전, 공유, 첨부 파일, 휴지통, 업로드 토큰, 검색을 다룹니다. OpenAPI·HTML 문서도 create_documents·update_documents로 만들고 고칩니다. HTML 문서는 원문 HTML을 typePayload의 content로 넘깁니다.

  • list_workspaces, list_projects, list_documents
  • create_documents, update_documents, move_documents
  • list_versions, restore_versions, search_documents

ERD​

테이블, 컬럼, 관계, Enum, 테이블 그룹과 테이블 배치를 다룹니다.

  • erd_list_tables, erd_get_table, erd_list_refs, erd_apply_changes, erd_arrange_tables

다이어그램​

노드, 연결선, 그룹을 다룹니다.

  • diagram_list_nodes, diagram_list_edges, diagram_get_node, diagram_apply_changes

Markdown​

  • markdown_generate_document, markdown_append_document

예시 요청​

블로그 데이터베이스 테이블을 만들어줘. users(id, email, name, created_at), posts(id, user_id, title, content), comments(id, post_id, user_id, content)

Agent가 AiNecto 도구로 테이블과 관계를 만듭니다.

AiNecto CLI​

CLI는 같은 도구를 터미널이나 스크립트에서 직접 부릅니다. AI Agent 없이 자동화할 때 씁니다. Agent 연결은 CLI가 아니라 MCP로 합니다. Node.js 18 이상이 필요합니다.

이 기기 설정(권장)​

기기마다 한 번 실행합니다. 필요하면 브라우저로 로그인하고, 연결을 확인한 뒤 Claude Code·Cursor·Codex를 연결합니다. 모든 세션이 같은 도구를 받으며, 바꿀 수 있는 범위는 AiNecto 프로젝트 권한을 따릅니다.

npx -y ainecto@latest setup

상태는 ainecto status, 문제와 고치는 명령은 ainecto doctor로 확인합니다. --dry-run으로 미리 보고, --undo로 연결을 지웁니다.

저장소 규칙 추가(선택)​

저장소 맨 위에서 실행합니다. AiNecto 작업 규칙(.ainecto/HARNESS.md와 AGENTS.md의 한 단락)을 씁니다. --mcp를 붙이면 프로젝트의 .mcp.json도 씁니다. 오래된 저장소에서 다시 실행하면 설정을 정리합니다.

npx -y ainecto@latest init

설치​

ainecto 명령을 직접 쓰려면(스크립트·CI) 설치합니다.

npm install -g ainecto
ainecto --version

업데이트는 npm install -g ainecto@latest입니다. 설치하지 않으려면 명령 앞에 npx -y ainecto@latest를 붙입니다.

로그인​

브라우저 창을 한 번 열고, 토큰은 이 기기에 둡니다.

ainecto auth login
ainecto auth status

사용​

ainecto projects list
ainecto tools list
ainecto tools call list_projects --json
ainecto erd apply-changes -f erd-operations.json --yes

CLI는 서버에 직접 붙으므로 접두어 없는 도구 이름을 씁니다. 전체 목록은 ainecto tools list로 봅니다.

로그아웃​

ainecto auth logout