CLI와 연결 문제 해결
모든 Agent 연결의 기반은 MCP입니다. 앱에서 원격 MCP 주소를 직접 등록할 수도 있고, npm을 실행할 수 있는 기기에서는 AiNecto CLI로 Codex·Claude Code·Cursor 연결을 한 번에 설정할 수 있습니다.
AiNecto CLI로 연결하기
npx -y ainecto@latest setup
setup은 AiNecto 로그인과 MCP 서버 연결을 확인하고, 설치된 Codex·Claude Code·Cursor에 AiNecto MCP를 등록합니다. 한 Agent의 설정이 실패하더라도 다른 Agent의 결과와 실패한 항목을 구분해 보여줍니다.
현재 상태를 확인합니다.
npx -y ainecto@latest status
연결 문제와 오래된 설정을 진단합니다.
npx -y ainecto@latest doctor
CLI를 사용할 수 없거나 ChatGPT·Claude 앱에서 연결한다면 각 제품 문서의 앱 설정에서 원격 MCP 주소를 직접 등록합니다.
공통 연결 문제
연결이 되지 않을 때는 주소, 인증, 권한, Agent의 도구 활성화 상태 순서로 확인합니다.
1. 연결값 확인
- 이름:
AiNecto - 서버 주소:
https://ainecto.com/mcp - 원격 전송 방식:
HTTP또는Streamable HTTP - 인증: AiNecto 브라우저 로그인
예전 주소, 중복 서버 또는 같은 이름의 다른 설정이 있다면 현재 연결 하나만 남기고 다시 확인합니다.
2. Agent에서 서버 상태 확인
- ChatGPT — Plugins에서 AiNecto가 설치·활성화되어 있는지 확인합니다.
- Codex —
codex mcp list에서ainecto를 확인합니다. - Claude — 대화의 Connectors에서 AiNecto가 켜져 있는지 확인합니다.
- Claude Code —
claude mcp list또는/mcp에서 상태를 확인합니다. - 기타 Agent — MCP 도구 선택기에서 AiNecto가 활성화되어 있는지 확인합니다.
3. 인증 확인
브라우저 인증이 열리면 실제 작업에 사용할 AiNecto 계정으로 로그인합니다. 인증 창을 닫았거나 세션이 만료됐다면 Agent의 MCP 관리 화면에서 다시 연결합니다.
토큰, 비밀번호 또는 개인 키를 프롬프트·문서·댓글에 붙여 넣지 않습니다.
4. 권한 확인
내가 접근할 수 있는 AiNecto 워크스페이스와 프로젝트를 보여줘.
목록 자체가 보이지 않으면 연결 또는 인증 문제일 가능성이 큽니다. 목록은 보이지만 원하는 프로젝트가 없다면 AiNecto 웹에서 해당 계정의 공유와 권한을 확인합니다.
Agent는 연결된 사용자의 권한을 그대로 사용합니다. 프롬프트로 권한을 높일 수 없습니다. 초대가 거절되면 요금제와 프로젝트 역할을 확인합니다 — 사용 중인 Agent 연결하기를 참고하세요.
5. 읽기와 쓰기 분리 확인
먼저 기준 문서를 읽게 합니다.
[프로젝트 이름]에서 프로젝트 기준 Markdown 문서를 찾아 읽어줘.
읽기는 되지만 생성·수정이 되지 않는다면 Agent의 워크스페이스 정책, 보안 설정 또는 도구 승인 설정이 쓰기 동작을 제한하는지 확인합니다.
오류를 구분하기
- 서버가 보이지 않음 — 설정 위치, 주소 또는 Agent의 MCP 지원 문제
- 로그인이 열리지 않음 — 인증 발견 또는 팝업 차단 문제
- 다른 프로젝트가 보임 — 다른 AiNecto 계정으로 인증
- 권한 거절 — 프로젝트·폴더·문서 권한 부족
- 읽기만 가능 — 플랜·관리자 정책·도구 승인 제한
- 연결 실패 — Agent 버전, 네트워크 또는 일시적 서버 문제
지원 요청에는 Agent 이름과 버전, 운영체제, 실패한 단계, 오류 메시지, 워크스페이스·프로젝트 목록 조회 여부를 포함합니다. 비밀값은 제외합니다.