MCP Tool Reference

Ainecto MCP 서버는 단일 namespace mcp__ainecto__ 아래 102개 tool을 제공합니다. 기존 product별 namespace prefix는 더 이상 등록되지 않습니다.

카탈로그는 다섯 그룹으로 나뉩니다.

그룹	개수	범위
Generic backbone	37	workspace, project, folder, document, version, share, attachment, search
ERD	22	ERD content: table, ref, table group, enum, batch apply, auto layout
Flow	19	flow diagram node, edge, group, LLM request handoff
Testcase	22	scenario, testcase, run, execution, step check
Readme	2	README append와 AI generation helper

정확한 기계 판본 JSON Schema는 MCP tools/list 응답이 단일 진실원입니다. 이 문서는 같은 카탈로그를 prompt 작성과 수동 확인에 맞게 요약합니다.

---

이름 규칙

• 모든 tool 이름은 mcp__ainecto__로 시작합니다.
• 문서 타입은 erd, flow_diagram, readme, testcase입니다.
• 최상위 group 용어는 workspace로 통일되었습니다. workspaceUuid / workspaceId를 사용하며 workspace에 groupUuid를 쓰지 않습니다.
• ERD 문서 자체의 생성/목록/수정/삭제는 generic document tool을 사용합니다: create_documents(type=erd), list_documents(type=erd), get_document, update_documents, delete_documents.
• ERD content tool은 부모 ERD 문서를 documentUuid로 받습니다.
• Flow residual tool은 부모 flow_diagram 문서를 diagramUuid로 받습니다.
• Testcase scenario/testcase는 부모 testcase 문서를 documentUuid로 받습니다. run은 project-level이며 numeric projectId를 사용합니다.
• public share는 enable_shares(targetType=project|folder|document, targetUuids)와 disable_shares(...)로 통합되었습니다.

---

Generic Backbone Tools (37)

Tool	주요 input shape	목적
mcp__ainecto__list_workspaces	없음	접근 가능한 workspace 목록
mcp__ainecto__get_workspace	uuid	workspace 단건 조회
mcp__ainecto__create_workspaces	items[]	workspace 생성
mcp__ainecto__update_workspaces	items[].uuid	workspace 이름/속성 수정
mcp__ainecto__delete_workspaces	uuids[]	workspace archive
mcp__ainecto__unarchive_workspaces	uuids[]	archive된 workspace 복원
mcp__ainecto__list_projects	workspaceUuid?	project 목록
mcp__ainecto__get_project	uuid	project 단건 조회
mcp__ainecto__create_projects	items[].workspaceUuid, items[].name	project 생성
mcp__ainecto__update_projects	items[].uuid	project 수정
mcp__ainecto__delete_projects	uuids[]	project archive
mcp__ainecto__unarchive_projects	uuids[]	archive된 project 복원
mcp__ainecto__list_folders	projectUuid?, parentUuid?	folder 목록
mcp__ainecto__create_folders	items[].projectUuid, items[].name	folder 생성
mcp__ainecto__update_folders	items[].uuid	folder 이름 수정
mcp__ainecto__move_folders	items[].uuid, items[].parentUuid?	folder 이동
mcp__ainecto__delete_folders	uuids[]	folder archive
mcp__ainecto__unarchive_folders	uuids[]	archive된 folder 복원
mcp__ainecto__list_documents	projectUuid?, folderUuid?, type?, q?, limit?	document 목록 또는 검색
mcp__ainecto__get_document	uuid	document 단건 조회
mcp__ainecto__create_documents	items[].projectUuid, items[].type, items[].title, items[].typePayload?	ERD, flow, README, testcase document 생성
mcp__ainecto__update_documents	items[].uuid, items[].title?, items[].typePayload?	document metadata 또는 type payload 수정
mcp__ainecto__move_documents	items[].uuid, items[].folderUuid?	document 이동
mcp__ainecto__delete_documents	uuids[]	document archive
mcp__ainecto__unarchive_documents	uuids[]	archive된 document 복원
mcp__ainecto__list_trash	선택 filter	archive된 resource 조회
mcp__ainecto__list_versions	documentUuid	document version 목록
mcp__ainecto__get_version	documentUuid, version	version snapshot 조회
mcp__ainecto__restore_versions	items[].documentUuid, items[].version	이전 version 복원
mcp__ainecto__enable_shares	targetType, targetUuids[]	project/folder/document public share 활성화
mcp__ainecto__disable_shares	targetType, targetUuids[]	public share 비활성화
mcp__ainecto__list_attachments	projectUuid?, documentUuid?	attachment 목록
mcp__ainecto__get_attachment	uuid	attachment metadata 조회
mcp__ainecto__upload_attachments	items[]	attachment 업로드
mcp__ainecto__delete_attachments	uuids[]	attachment 삭제/archive
mcp__ainecto__request_upload_token	purpose, scopeJson?, maxBytes?, ttlSeconds?	upload 또는 one-shot MCP call token 발급
mcp__ainecto__search_documents	q, type?, projectUuid?, limit?, offset?	document full-text search

Document CUD Schema

document CUD는 복수형 tool을 사용합니다. 각 items[] 원소는 document type과 선택적 typePayload를 가집니다.

{
  "items": [
    {
      "projectUuid": "<project-uuid>",
      "folderUuid": "<optional-folder-uuid>",
      "type": "erd",
      "title": "Production schema",
      "typePayload": {}
    }
  ]
}

type별 payload:

Type	typePayload
erd	보통 비워 둡니다. ERD content는 erd_* tool로 관리합니다.
flow_diagram	diagramSource?, sourceLanguage?, edgeStyle?, isModule?, metadata?
readme	body
testcase	defaultEnvironment?, defaultTestAccount?

README 본문이 크면 mcp__ainecto__request_upload_token을 purpose=document.create, document.update, document.append 중 하나로 호출한 뒤, chat prompt가 아니라 upload endpoint로 직접 본문을 전송하세요.

---

ERD Tools (22)

ERD document lifecycle은 generic tool이 담당합니다. list_documents(type=erd)로 ERD document를 찾은 뒤, 해당 UUID를 documentUuid로 넘겨 아래 tool을 호출합니다.

Tool	주요 input shape	목적
mcp__ainecto__erd_apply_changes	documentUuid, description, operations[], arrangeNewTables?	ERD entity 일괄 create/update/delete
mcp__ainecto__erd_arrange_tables	documentUuid, full?	신규 또는 전체 table 자동 정렬
mcp__ainecto__erd_list_tables	documentUuid	table 목록
mcp__ainecto__erd_get_table	documentUuid, tableUuid	table 단건 조회
mcp__ainecto__erd_create_tables	documentUuid, description, tables[]	table 생성
mcp__ainecto__erd_update_tables	documentUuid, description, tables[].tableUuid	table 수정
mcp__ainecto__erd_delete_tables	documentUuid, description, tableUuids[]	table 삭제
mcp__ainecto__erd_list_refs	documentUuid	relationship 목록
mcp__ainecto__erd_get_ref	documentUuid, refUuid	relationship 단건 조회
mcp__ainecto__erd_create_refs	documentUuid, description, refs[]	relationship 생성
mcp__ainecto__erd_update_refs	documentUuid, description, refs[].refUuid	relationship 수정
mcp__ainecto__erd_delete_refs	documentUuid, description, refUuids[]	relationship 삭제
mcp__ainecto__erd_list_table_groups	documentUuid	table group 목록
mcp__ainecto__erd_get_table_group	documentUuid, tableGroupUuid	table group 단건 조회
mcp__ainecto__erd_create_table_groups	documentUuid, description, tableGroups[]	table group 생성
mcp__ainecto__erd_update_table_groups	documentUuid, description, tableGroups[].tableGroupUuid	table group 수정
mcp__ainecto__erd_delete_table_groups	documentUuid, description, tableGroupUuids[]	table group 삭제
mcp__ainecto__erd_list_enums	documentUuid	enum 목록
mcp__ainecto__erd_get_enum	documentUuid, enumUuid	enum 단건 조회
mcp__ainecto__erd_create_enums	documentUuid, description, enums[]	enum 생성
mcp__ainecto__erd_update_enums	documentUuid, description, enums[].enumUuid	enum 수정
mcp__ainecto__erd_delete_enums	documentUuid, description, enumUuids[]	enum 삭제

주요 ERD schema:

• erd_create_tables.tables[]: name 필수, 선택 schemaName, alias, note, headerColor, displayOrder.
• erd_update_tables.tables[]: tableUuid 필수, 선택 name, schemaName, alias, note, headerColor, displayOrder.
• erd_create_refs.refs[]: fromTableUuid, toTableUuid, refColumns[] 필수, 선택 name, relationship, onDelete, onUpdate.
• refColumns[]: {fromColumnUuid, toColumnUuid}.
• erd_apply_changes.operations[]: {op: create|update|delete, type, uuid?, data?}. type은 table, column, index, index_column, ref, ref_column, enum, enum_value, table_group, table_group_table, table_group_note, filter, note 중 하나입니다.

---

Flow Tools (19)

Flow document lifecycle은 generic tool이 담당합니다. create_documents(type=flow_diagram) 또는 list_documents(type=flow_diagram)로 document를 다루고, residual flow_* tool에는 document UUID를 diagramUuid로 넘깁니다.

Tool	주요 input shape	목적
mcp__ainecto__flow_apply_changes	diagramUuid, description, nodes?, edges?, groups?	node/edge/group 일괄 변경
mcp__ainecto__flow_list_nodes	diagramUuid	node 목록
mcp__ainecto__flow_get_node	diagramUuid, nodeUuid	node 단건 조회
mcp__ainecto__flow_create_nodes	diagramUuid, description, nodes[]	node 생성
mcp__ainecto__flow_update_nodes	diagramUuid, description, nodes[].uuid	node 수정
mcp__ainecto__flow_delete_nodes	diagramUuid, description, nodeUuids[]	node 삭제
mcp__ainecto__flow_list_edges	diagramUuid	edge 목록
mcp__ainecto__flow_get_edge	diagramUuid, edgeUuid	edge 단건 조회
mcp__ainecto__flow_create_edges	diagramUuid, description, edges[]	edge 생성
mcp__ainecto__flow_update_edges	diagramUuid, description, edges[].uuid	edge 수정
mcp__ainecto__flow_delete_edges	diagramUuid, description, edgeUuids[]	edge 삭제
mcp__ainecto__flow_list_groups	diagramUuid	group 목록
mcp__ainecto__flow_get_group	diagramUuid, groupUuid	group 단건 조회
mcp__ainecto__flow_create_groups	diagramUuid, description, groups[]	group 생성
mcp__ainecto__flow_update_groups	diagramUuid, description, groups[].uuid	group 수정
mcp__ainecto__flow_delete_groups	diagramUuid, description, groupUuids[]	group 삭제
mcp__ainecto__flow_get_pending_llm_requests	diagramUuid	pending LLM handoff request 목록
mcp__ainecto__flow_submit_llm_result	request-specific payload	LLM result 제출
mcp__ainecto__flow_update_llm_request_status	request-specific payload	LLM request status 수정

flow_apply_changes는 node/edge/group item마다 action: create|update|delete를 사용합니다. node field에는 type, text, shape, x, y, width, height, groupUuid, fillColor, strokeColor, textColor가 있고, edge field에는 fromUuid, toUuid, label, bridgeType, lineStyle, strokeColor, strokeWidth가 있습니다.

---

Testcase Tools (22)

testcase document는 generic document tool에서 type=testcase로 생성하거나 찾습니다. scenario/testcase tool은 documentUuid를 사용하고, run tool은 project-level numeric projectId를 사용합니다.

Tool	주요 input shape	목적
mcp__ainecto__testcase_list_scenarios	documentUuid	scenario 목록
mcp__ainecto__testcase_create_scenarios	items[].documentUuid, items[].name	scenario 생성
mcp__ainecto__testcase_update_scenarios	items[].scenarioId	scenario 수정
mcp__ainecto__testcase_archive_scenarios	scenarioIds[]	scenario archive
mcp__ainecto__testcase_reorder_scenarios	reorder payload	scenario 순서 변경
mcp__ainecto__testcase_list_testcases	documentUuid	testcase 목록
mcp__ainecto__testcase_get_testcase	testcaseId	testcase 단건 조회
mcp__ainecto__testcase_create_testcases	items[].scenarioId, items[].title	testcase 생성
mcp__ainecto__testcase_update_testcases	items[].testcaseId	testcase 수정
mcp__ainecto__testcase_delete_testcases	testcaseIds[]	testcase 삭제
mcp__ainecto__testcase_reorder_testcases	reorder payload	testcase 순서 변경
mcp__ainecto__testcase_list_runs	projectId	test run 목록
mcp__ainecto__testcase_get_run	runId	run 단건 조회
mcp__ainecto__testcase_create_runs	items[].projectId, items[].name	test run 생성
mcp__ainecto__testcase_update_runs	items[].runId	test run 수정
mcp__ainecto__testcase_complete_runs	runIds[]	run 완료 처리
mcp__ainecto__testcase_delete_runs	runIds[]	run 삭제
mcp__ainecto__testcase_list_executions	run/testcase filter	execution 목록
mcp__ainecto__testcase_record_executions	items[].runId, items[].testCaseId, items[].result	execution result 기록
mcp__ainecto__testcase_list_step_checks	testcase/step filter	step check 목록
mcp__ainecto__testcase_upsert_step_checks	step-check payload	step check 생성/수정
mcp__ainecto__testcase_remove_run_cases	run/case payload	run에서 testcase 제거

execution result 값은 PASSED, FAILED, BLOCKED, SKIPPED, UNTESTED, IN_PROGRESS입니다.

---

Readme Tools (2)

README document의 full-body create/update는 generic tool을 사용합니다. create_documents(type=readme) 또는 update_documents에서 typePayload.body를 넘기세요.

Tool	주요 input shape	목적
mcp__ainecto__readme_append_document	document append payload	기존 README에 markdown append
mcp__ainecto__readme_generate_document	prompt/project payload	AI로 README document 생성

---

예시

ERD document 찾기

{
  "name": "mcp__ainecto__list_documents",
  "arguments": {
    "type": "erd",
    "q": "production schema",
    "limit": 10
  }
}

ERD document 생성

{
  "name": "mcp__ainecto__create_documents",
  "arguments": {
    "items": [
      {
        "projectUuid": "<project-uuid>",
        "type": "erd",
        "title": "Billing schema"
      }
    ]
  }
}

ERD document에 table 생성

{
  "name": "mcp__ainecto__erd_create_tables",
  "arguments": {
    "documentUuid": "<erd-document-uuid>",
    "description": "Add notification tables",
    "tables": [
      {"name": "notifications"},
      {"name": "notification_deliveries"}
    ]
  }
}

외래 키 추가

먼저 mcp__ainecto__erd_get_table로 table/column UUID를 조회한 뒤 호출합니다.

{
  "name": "mcp__ainecto__erd_create_refs",
  "arguments": {
    "documentUuid": "<erd-document-uuid>",
    "description": "FK notifications.user_id to users.id",
    "refs": [
      {
        "fromTableUuid": "<notifications-table-uuid>",
        "toTableUuid": "<users-table-uuid>",
        "relationship": ">",
        "onDelete": "CASCADE",
        "refColumns": [
          {
            "fromColumnUuid": "<notifications-user-id-column-uuid>",
            "toColumnUuid": "<users-id-column-uuid>"
          }
        ]
      }
    ]
  }
}

README document 생성

{
  "name": "mcp__ainecto__create_documents",
  "arguments": {
    "items": [
      {
        "projectUuid": "<project-uuid>",
        "type": "readme",
        "title": "API notes",
        "typePayload": {
          "body": "# API notes\n\nInitial draft."
        }
      }
    ]
  }
}

document 공유 활성화

{
  "name": "mcp__ainecto__enable_shares",
  "arguments": {
    "targetType": "document",
    "targetUuids": ["<document-uuid>"]
  }
}

---

오류 처리

tool은 표준 JSON-RPC error response를 반환합니다.

Error	원인
401 Unauthorized	token 누락 또는 만료. 재인증 필요
403 Forbidden	view/edit 권한 없음
404 Not Found	workspace, project, folder, document 또는 entity UUID 오류
409 Conflict	동시 편집 충돌. 현재 상태를 다시 읽고 재시도
429 Too Many Requests	rate limit. backoff 후 재시도

namespace 전환 후 tool call이 실패하면 먼저 tool 이름이 mcp__ainecto__로 시작하는지, document 작업이 새 복수형 CUD shape를 사용하는지 확인하세요.