Antigravity와
KNITFORM 연결하기
API 키 없이, 내 뜨개 작업실을 AI 에이전트에 연결해요.
Google Antigravity 공식 마켓플레이스 등록은 아직 완료되지 않았어요. 마켓플레이스의 ‘Add MCP Server’ 검색에 KNITFORM이 보이지 않아도 정상이에요.
플러그인 간편 설치
별도의 ZIP 다운로드나 JSON 파일 수정 없이 KNITFORM을 설치하는 방법이에요.
- Antigravity와 CLI 준비
Antigravity를 설치한 뒤 PowerShell에서
agy --version으로 CLI 사용 가능 여부를 확인해요. CLI가 없다면 Google 공식 CLI 안내를 참고해 설치하세요. - KNITFORM 플러그인 설치
아래 명령어 한 줄을 PowerShell에 붙여넣고 실행해요. 공개된 KNITFORM GitHub 저장소에서 플러그인을 가져와요.
agy plugin install https://github.com/Deligh-it/knitform-antigravity - 설치 확인
Antigravity 앱에서 Customizations → Installed → KNITFORM을 열어요. 플러그인에 MCP, Skills, Rules가 표시되면 설치된 거예요.
KNITFORM 계정 연결
설치 후에는 계정 소유자가 직접 OAuth 승인을 해야 해요.
- KNITFORM 계정으로 로그인
KNITFORM 마이페이지에서 Google 계정으로 로그인해 주세요.
- Antigravity에서 인증
Customizations → Installed → KNITFORM → Accounts로 이동해 Sign in / Authenticate를 눌러요.
- 브라우저 승인
브라우저에서 KNITFORM 연결을 허용하고, 화면에 인증 코드가 표시되면 Antigravity 안내에 따라 입력해요. OAuth 권한 범위를 확인한 후 승인하세요.
- 연결 확인
KNITFORM 플러그인의 MCP 탭에 녹색 상태 표시와 활성 도구가 나타나는지 확인하세요.
KNITFORM의 OAuth를 이용하므로 API 키·비밀번호·Bearer 토큰을 AI 채팅에 붙여넣지 마세요.
실제 MCP 호출 테스트
Antigravity 에이전트 대화에 아래 문장을 보내 보세요.
KNITFORM MCP의 list_stitches 도구를 실제로 호출해서 지원하는 뜨개 기호 목록을 보여줘. 도구를 호출하지 않았다면 추측하지 말고 알려줘.도구 호출 결과가 반환되면 연결 성공이에요. 도구별 사용 권한은 승인한 OAuth 범위에 따라 달라질 수 있어요.
수동 MCP 연결 (대체 방법)
CLI나 플러그인을 사용할 수 없는 환경에서만 참고해 주세요. 기존 MCP 설정은 지우지 마세요.
직접 설정하는 방법 보기
Antigravity의 MCP 설정 파일에서 기존 mcpServers 객체 안에 knitform 항목만 추가해요. 아래 JSON은 구조를 보여주는 예시예요. 이미 야몽 등 다른 서버를 연결했다면 반드시 기존 설정을 유지하세요.
{
"mcpServers": {
"knitform": {
"url": "https://knitform.deligh-it.app/mcp"
}
}
}설정을 저장하고 Antigravity에서 MCP 구성을 새로고침한 뒤 OAuth 인증을 진행해요. KNITFORM은 Streamable HTTP 및 OAuth DCR을 지원하므로 인증 토큰을 직접 입력하지 않아요. Antigravity MCP 공식 문서
연결이 안 될 때
‘Add MCP Server’ 검색에 KNITFORM이 없어요.
그 창은 서버 카탈로그 검색용이에요. 마켓플레이스 등록 전의 KNITFORM은 현재 GitHub 플러그인으로 설치한 뒤 Installed 탭에서 확인해 주세요.
KNITFORM에 ‘Setup required’가 떠요.
대부분 계정 인증이 아직 완료되지 않았을 때 나타나요. 플러그인 상세 페이지의 Accounts에서 KNITFORM에 로그인하고 다시 MCP 탭을 확인해 주세요.
로그인은 했는데 MCP 도구를 사용할 수 없어요.
앱에서 플러그인 활성 상태 및 MCP 연결 상태를 확인하고, 필요하면 다시 인증해 주세요. 해결되지 않으면 문의하기에 오류 문구와 발생 단계만 알려 주세요. 토큰이나 인증 코드는 공유하지 마세요.
다른 사람에게 내 도안이 자동으로 보이나요?
아니요. 계정에 저장한 도안은 현재 기본 비공개예요. 외부 AI가 내 도안을 읽거나 수정할 수 있는 범위는 연결 시 승인한 OAuth 권한에 따라 달라집니다. 마이페이지에서 사용자가 선택한 도안에 한해 읽기 전용 공유 링크를 만들 수 있어요.
연결 과정에서 막혔나요?
오류 메시지와 어떤 단계에서 막혔는지 알려 주시면 확인해 드릴게요.