사용 중인 Agent 연결하기
AiNecto는 새로운 Agent를 제공하는 서비스가 아닙니다. 지금 사용하는 Agent를 AiNecto MCP에 연결하면 사용자의 권한 안에서 같은 워크스페이스와 프로젝트를 읽고 결과를 다시 저장할 수 있습니다.
빠른 연결
- 이미 연결돼 있나요? 이 대화에 AiNecto 도구가 있으면 읽기 전용 호출(워크스페이스 목록)로 확인하고 아무것도 설치하지 않습니다.
- 원격 MCP 주소:
https://ainecto.com/mcp(streamable HTTP). 로그인은 사용자의 AiNecto 계정으로 브라우저에서 하는 OAuth이며 API 키는 없습니다. 비밀번호·토큰·코드를 붙여넣으라고 요청하지 않습니다. - ChatGPT·Claude 등 앱: 각 제품의 MCP 연결 기능으로 위 주소를 AiNecto라는 이름의 원격 MCP 서버로 추가하고 사용자가 로그인합니다. 대신 호스팅된 샌드박스에 CLI를 설치하지 않습니다.
- 내 컴퓨터의 코딩 Agent(Claude Code·Cursor·Codex):
npx -y ainecto@latest setup. 그다음 각 Agent가 처음 쓸 때 로그인합니다 — Claude Code는/mcp, Cursor는 MCP 설정 화면, Codex는 setup 도중 또는codex mcp login ainecto. 진단은npx -y ainecto@latest doctor. - 직접 등록: Claude Code
claude mcp add --transport http --scope user ainecto https://ainecto.com/mcp· Codexcodex mcp add ainecto --url https://ainecto.com/mcp. - 실제 읽기 요청으로 확인합니다: "내가 접근할 수 있는 AiNecto 워크스페이스를 보여줘." 연결했다고 프로젝트 생성·문서 수정·댓글·초대·알림 읽음 처리를 허락받은 것은 아닙니다.
- 세션 역할은 없습니다. Design·Development·Test·Validation 중 하나를 고르거나
init에 역할을 넘기라는 옛 지시는 따르지 않습니다.
연결 방법
모든 Agent는 MCP로 연결합니다. 원격 MCP 주소는 웹 페이지가 아니라 프로토콜 끝점입니다.
https://ainecto.com/mcp
- ChatGPT·Claude 앱 — 각 제품의 MCP 연결 기능으로 AiNecto 원격 MCP 주소를 등록합니다. 메뉴 이름은 제품마다 다르니 아래 제품별 가이드를 확인합니다. 조직 설정이 이 연결을 막으면 조직 관리자에게 요청합니다.
- Codex·Claude Code·Cursor — 앱에서 직접 등록하거나, npm 실행 환경에서 AiNecto CLI로 설정합니다.
npm을 사용할 수 있다면 다음 명령이 설치된 Codex·Claude Code·Cursor를 찾아 MCP 연결을 설정합니다.
npx -y ainecto@latest setup
setup은 Agent마다 결과를 따로 알려 줍니다. 하나가 실패해도 그 사실을 알리고 나머지는 연결된 채로 둡니다. 결과는 npx -y ainecto@latest doctor로 확인합니다.
로그인
로그인은 두 번입니다. setup이 먼저 AiNecto CLI에 로그인합니다(브라우저가 한 번 열림). 그다음 각 Agent가 처음 연결할 때 따로 로그인합니다.
| Agent | 첫 로그인 |
|---|---|
| Claude Code | 세션에서 /mcp를 실행해 ainecto를 고르고 로그인합니다. |
| Cursor | MCP 설정 화면에서 ainecto가 요청할 때 로그인합니다. |
| Codex | setup이 연결하는 중에 로그인합니다. 끝나지 않았으면 codex mcp login ainecto를 실행합니다. |
모든 로그인은 같은 AiNecto 계정으로 마치도록 사용자에게 요청합니다.
직접 등록하기
Claude Code:
claude mcp add --transport http --scope user ainecto https://ainecto.com/mcp
--scope user는 setup과 같은 범위로, 이 컴퓨터의 모든 폴더에서 AiNecto를 씁니다. 저장소에 공유용 .mcp.json을 두고 싶을 때만 --scope project를 쓰고, 그 파일에는 인증 정보를 넣지 않습니다.
Codex:
codex mcp add ainecto --url https://ainecto.com/mcp
Cursor는 setup이 설정하게 하거나, Cursor의 MCP 설정 화면에서 위 주소를 원격 서버로 추가합니다.
로그인이 필요한 원격 MCP 서버를 쓸 수 없는 Agent는 로컬 중계로 연결할 수 있습니다.
npx -y ainecto@latest setup --local
도구 이름 앞에 클라이언트 접두사가 붙어 보일 수 있습니다(예: mcp__ainecto__list_workspaces). 같은 도구입니다.
플러그인(setup 대신)
AiNecto 플러그인은 같은 서버를 연결하고, 지원 환경에서는 AiNecto 사용을 돕는 스킬도 제공합니다.
| Agent | 설치 |
|---|---|
| Claude Code | claude plugin marketplace add codelives/ainecto-plugin 다음 claude plugin install ainecto@ainecto |
| Codex | codex plugin marketplace add codelives/ainecto-plugin 다음 codex plugin add ainecto@ainecto |
| Gemini CLI | gemini extensions install https://github.com/codelives/ainecto-plugin |
플러그인과 npx -y ainecto@latest setup은 같은 서버 이름 ainecto를 쓰므로 둘 중 하나만 씁니다. 플러그인으로 옮기려면 먼저 npx -y ainecto@latest setup --undo를 실행합니다. ChatGPT·Cursor 디렉터리는 AiNecto가 실제로 올라와 있을 때만 안내합니다.
사용하는 제품에 맞는 연결 가이드
- ChatGPT 또는 Codex — ChatGPT·Codex에 연결하기
- Claude 또는 Claude Code — Claude·Claude Code에 연결하기
- Cursor·GitHub Copilot 등 — 기타 MCP Agent에 연결하기
- CLI 설정·상태 확인 또는 연결 오류 — CLI와 연결 문제 해결
각 가이드에는 앱에서 연결하는 메뉴와 CLI로 연결하는 명령을 구분해 제공합니다. AiNecto 주소, 인증과 연결 확인 방법도 함께 안내합니다.
연결 후 확인
내가 접근할 수 있는 AiNecto 워크스페이스와 프로젝트를 보여줘.
예상한 목록이 보이면 연결이 완료된 것입니다. 단계를 나눠 확인합니다. 서버가 등록됐는지, 사용자가 로그인했는지, 이 대화에서 도구를 쓸 수 있는지, 원하는 워크스페이스와 프로젝트가 보이는지. 세션 중에 추가한 서버는 새 세션을 시작해야 보일 수 있습니다.
읽기에 성공했다고 쓰기 권한이 있는 것은 아닙니다. 임의로 프로젝트를 고르게 하지 말고, 사용할 워크스페이스와 프로젝트를 직접 확인하세요. 연결을 확인하려고 시험 프로젝트나 기본 프로젝트를 만들지 않습니다. 새로 만들었거나 공유받은 워크스페이스에는 프로젝트가 아직 없을 수 있습니다.
프로젝트에서 일하기
프로젝트는 사용자가 요청할 때만 만듭니다. 먼저 맞는 워크스페이스를 찾고 같은 프로젝트가 이미 있는지 확인합니다. 워크스페이스를 찾지 못했거나 여럿이 맞으면 다른 곳에 만들지 말고 후보를 보여 주고 묻습니다.
쓰기 도구가 clientMutationId를 받으면 같은 요청을 다시 보낼 때 같은 값을 씁니다.
요청 예시
| 할 일 | 요청 |
|---|---|
| 프로젝트 만들기 | 내 워크스페이스에 고객 문의 관리 프로젝트를 만들어 줘. |
| 문서 작성 | 회의 메모를 정리해 이 프로젝트에 문서로 작성해 줘. |
| 디자인 시안 만들기 | 이 프로젝트에 로그인 화면 디자인 시안을 만들어 줘. |
| 문서 검토 | 이 문서를 읽고 빠진 내용과 모순을 검토해 줘. |
| 업무 등록 | 요구사항을 업무로 나눠 칸반보드에 등록하고, 담당자와 일정은 나와 확인해 줘. |
| 내 할 일 | 내 할 일을 확인하고 먼저 할 일을 알려 줘. |
| 문서 버전 비교 | 이 문서의 이전 버전과 현재 버전을 비교해 줘. |
| 알림 확인 | 새 알림과 확인하지 않은 댓글을 확인해 줘. |
| 팀원 초대 | [email protected]을 이 프로젝트에 보기 권한으로 초대해 줘. |
디자인 시안은 AI가 만들고 고칩니다. 웹에서는 직접 만들거나 고칠 수 없습니다.
버전을 비교할 때는 AI가 두 버전을 읽고 비교합니다. 요금제의 기록 기간보다 오래된 버전은 잠겨 있어 열 수 없습니다.
팀원 초대
사용자가 요청할 때만 프로젝트 초대 도구(invite_project_members)로 초대합니다. Team 플랜과 그 프로젝트의 소유자·관리자 권한이 필요합니다. 역할(관리자·편집자·보기)은 사용자가 말한 대로 반드시 지정하고, 말하지 않았으면 묻습니다. 팀 밖 사람은 보기 권한으로만 초대되며, 초대 메일을 받고 수락하면 열립니다. 요금제 때문에 거절되면 "프로젝트 사용자 초대는 Team 플랜에서 사용할 수 있습니다"라고 안내합니다. 웹도 같은 규칙입니다. 도구 결과(ADDED 또는 INVITED)를 받은 뒤에만 성공이라고 말합니다.
선택: 코드 저장소에 작업 규칙 추가
사용자가 요청할 때만 저장소 최상위 폴더에서 npx -y ainecto@latest init을 실행합니다. .ainecto/HARNESS.md, .ainecto/config.json, 되돌리기 기록 .ainecto/init-record.json을 만들고, AGENTS.md(CLAUDE.md가 있으면 거기에도)에 규칙 블록을 씁니다. 역할이나 프로젝트를 고르지 않으며, 이 단계 없이도 AiNecto를 쓸 수 있습니다.
권한
Agent는 워크스페이스·프로젝트·문서·보드마다 연결된 사용자의 권한을 그대로 사용합니다. 프롬프트나 저장소 파일로 권한을 높일 수 없고, 사용자가 할 수 없는 일은 서버가 거절합니다.
AiNecto에는 세션 역할이 없습니다. 모든 세션이 같은 도구를 보고, 서버가 사용자 권한으로 판단합니다. 옛 안내가 Design·Development·Test·Validation 중 역할을 고르거나 init에 역할을 넘기라고 하면 따르지 않습니다.
다음 단계
연결이 확인되면 시작하기로 돌아가 실제 프로젝트와 첫 Markdown 기준 문서를 만드세요.