ainote

테마

Cursor / Windsurf 연결 ​

Cursor 와 Windsurf 는 hosted HTTP transport 를 1급 지원. Claude Code 와 거의 동일.

Cursor ​

1. 설정 파일 ​

~/.cursor/mcp.json (없으면 생성):

json
{
  "mcpServers": {
    "ainote": {
      "type": "http",
      "url": "https://api.ainote.dev/api/mcp",
      "headers": {
        "Authorization": "McpKey YOUR_KEY"
      }
    }
  }
}

2. Cursor 재시작 ​

Cmd+Shift+P → "Cursor: Reload Window".

3. 검증 ​

Cmd+L (Composer/Chat 패널) → "@" 입력 → ainote 도구 17개 보여야 함.

테스트:

@ainote create_task "Cursor 테스트"

Windsurf ​

1. 설정 파일 ​

~/.codeium/windsurf/mcp_config.json:

json
{
  "mcpServers": {
    "ainote": {
      "type": "http",
      "url": "https://api.ainote.dev/api/mcp",
      "headers": {
        "Authorization": "McpKey YOUR_KEY"
      }
    }
  }
}

2. Windsurf 재시작 ​

3. Cascade 패널 → MCP 도구 사용 ​

Project-level (한 프로젝트만) ​

두 IDE 모두 프로젝트 루트의 .mcp.json 또는 .cursor/mcp.json 지원:

json
{
  "mcpServers": {
    "ainote": {
      "type": "http",
      "url": "https://api.ainote.dev/api/mcp",
      "headers": { "Authorization": "McpKey TEAM_KEY" }
    }
  }
}

⚠️ git 에 커밋 X — .gitignore 에 추가:

.cursor/mcp.json
.mcp.json

Cursor Rules / Windsurf Rules 연동 ​

ainote 의 Dev Docs 가 두 IDE 의 rules 파일을 중앙 관리.

Cursor .cursorrules 동기화 ​

ainote 에 등록:

.cursorrules 를 ainote 에 등록해줘
- title: "{project}-cursorrules"
- category: "cursor"
- local_path: "/Users/seunghan/{project}/.cursorrules"

다른 기기에서:

ainote 에서 cursor rules 다 가져와

→ pull_dev_docs --category cursor → 모든 .cursorrules 복원.

Windsurf .windsurfrules 도 동일 ​

category: "windsurf"
local_path: ".windsurfrules"

도구 호출 자동 승인 ​

Cursor: Cmd+, → "MCP" → "Auto-approve tool calls" → ainote 의 read-only 도구만 자동 승인 권장:

  • ✅ list_*, get_*, pull_* 자동
  • ⚠️ create_*, update_*, delete_* 수동 승인

Troubleshooting ​

증상해결
도구 안 뜸type: "http" 누락 확인
Cursor 재시작 후도 안 됨~/.cursor/logs/ 에서 MCP 에러 확인
Windsurf cascade 에러~/.codeium/windsurf/logs/ 확인

다음 ​

MIT License · ainote.dev

Built by Dcode Labs