도구 목록과 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_documentscreate_documents,update_documents,move_documentslist_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