Cursor

Cursor를 MCP로 Ainecto에 연결해 실제 project document를 읽고 수정하게 합니다.

---

Ainecto MCP 서버 추가

Cursor의 MCP 설정에 Ainecto server를 추가합니다. 일반적인 형태는 다음과 같습니다.

{
  "mcpServers": {
    "ainecto": {
      "type": "http",
      "url": "https://ainecto.com/mcp"
    }
  }
}

Cursor를 reload하거나 restart합니다. 첫 Ainecto tool call에서 OAuth flow가 시작됩니다.

Cursor의 설정 UI와 파일 위치는 버전에 따라 바뀔 수 있습니다. 현재 버전의 MCP 설정 안내를 확인하세요.

---

사용해 보기

Cursor Chat에서:

List my Ainecto ERD documents and summarize the tables in each one.

Use ERD document <uuid>. Before editing code, inspect the users and sessions tables from Ainecto.

Cursor는 Ainecto tool을 호출해 실제 schema context를 가져온 뒤 코드 작업에 반영합니다.

---

쓰기 요청

스키마를 바꾸는 요청에는 항상 명확한 설명을 포함하세요.

In ERD document <uuid>, add a nullable deleted_at timestamp to all user-owned tables.
Use description "Add soft delete columns".

MCP write는 Ainecto에서 version snapshot을 생성하므로 나중에 비교하거나 복원할 수 있습니다.

---

팁

• 코드 변경 전에 "read the schema from Ainecto first"라고 명시하면 Cursor가 추측 대신 tool call을 사용하기 쉽습니다.
• ERD document UUID를 prompt 상단에 고정해 두세요.
• 큰 스키마 변경은 Cursor가 제안한 뒤 Ainecto에서 diff와 version history를 확인하는 흐름이 안전합니다.

---

문제 해결

Ainecto tool이 보이지 않음
MCP 설정 JSON과 Cursor 재시작 여부를 확인하세요.

OAuth가 실패함
브라우저에서 Ainecto 로그인 세션이 유효한지 확인하고 다시 tool call을 실행하세요.

Write가 거부됨
대상 document에서 OWNER 또는 EDITOR 권한이 필요합니다.