시작하기 전에
먼저 백엔드와 앱 버전을 확인하세요.
이 흐름은 국제 iOS 공용 백엔드를 대상으로 합니다. app.squirrelly.ai는 서비스 도메인과 API로 유지되며 Web 소프트웨어나 Web 로그인은 필요하지 않습니다. 다른 백엔드에서는 같은 이메일도 별도 계정일 수 있습니다.
| 계정 버전 | 현재 상태 |
|---|---|
| 국제 iOS 공용 백엔드 | 연결 테스트 · 새 앱 필요 |
| 필요한 네이티브 앱 기능 | 설정 → 에이전트 연결. 새 빌드가 필요하며 현재 설치된 버전이나 App Store 버전에 이미 있다고 가정하지 않습니다. |
| 국제판 Android Play 독립 계정 | 아직 지원하지 않음 |
| 중국판, HarmonyOS 등의 독립 계정 | 아직 지원하지 않음 |
국제 iOS 공용 백엔드만 대상입니다. 별도 국제 Android Play, 중국판, HarmonyOS 백엔드는 활성화되지 않았습니다. 에이전트 연결이 없다면 업데이트하거나 호환 버전 출시를 기다리세요. 대체 Web 계정을 만들지 마세요.
단계 01
앱에서 글로벌 계정 번호 복사
- 네이티브 앱 설정 → 에이전트 연결을 여세요.
앱에 로그인된 기존 계정을 사용하세요. 앱 열기 안내 ↗는 앱을 여는 방법만 설명하며 Web 로그인이나 웹 계정 관리를 제공하지 않습니다.
- 앱 버전의 기능 지원을 확인하세요.
에이전트 연결이 포함된 새 네이티브 앱 빌드가 필요합니다. 항목이 없으면 업데이트하거나 출시를 기다리세요. 현재 설치 버전이나 App Store 버전이 지원한다고 가정하지 않습니다.
- 에이전트 연결에서 글로벌 계정 번호를 복사하세요.
번호는
ZXM-로 시작합니다. 같은 백엔드 계정의 번호는 유지됩니다. 브라우저 승인 요청에 입력하여 백엔드 계정을 식별합니다.
계정 번호는 올바른 계정을 찾기 위한 것이며, 비밀번호가 아닙니다. 일치하는 계정으로 로그인한 네이티브 앱에서 명시적으로 승인해야 접근할 수 있습니다.
앱 열기 안내 보기 ↗단계 02 · ChatGPT
ChatGPT에 Squirrelly 추가하기
아래는 사용자 지정 MCP의 테스트 연결 절차입니다. 플러그인 스토어의 원클릭 설치가 아닙니다. 사용 가능 여부는 ChatGPT 계정과 워크스페이스 정책에 따라 다릅니다.
- ChatGPT의 Plugins 페이지를 여세요.
다음으로 이동하세요: ChatGPT Plugins ↗. 더하기 버튼을 누른 뒤 Add custom MCP server(사용자 지정 MCP 서버 추가)를 선택하세요. 메뉴가 보이지 않으면 아래 자주 묻는 질문을 확인하세요.
- 연결 정보를 입력하세요.
이름은 “squirrellyai”로 입력하고 공개 HTTPS 엔드포인트를 선택하세요. 다음 끝부분을 포함한 전체 주소를 붙여 넣으세요:
/mcp.
ChatGPT 입력 설정(고급 OAuth 설정 포함)
| 설정 | 올바른 값 |
|---|---|
| 이름 | squirrellyai |
| 서버 URL | https://mcp.squirrelly.ai/mcp |
| 인증 방식 | OAuth |
| 등록 방법 | 사용자 지정 OAuth 클라이언트 |
| OAuth 클라이언트 ID | squirrelly-chatgpt |
| 클라이언트 시크릿 | 비워 두기 |
| Token 엔드포인트 인증 방법 | none |
| 등록 URL | 비워 두기 |
| OIDC 활성화 | 선택하지 않음 |
“고급 OAuth 설정”을 펼쳐 위 표대로 각 항목을 입력하세요. 클라이언트 ID는 반드시 squirrelly-chatgpt여야 하며 플러그인 이름이나 계정 번호로 대신할 수 없습니다.
DCR, CIMD 사용 불가 안내는 서버가 이 두 자동 등록 방식을 제공하지 않는다는 뜻입니다. “사용자 지정 OAuth 클라이언트”를 선택하고 표대로 입력하세요. 등록 URL은 비워 두고 OIDC를 활성화하지 마세요.
기본 요청 범위는 account:read, books:read, transactions:read, transactions:create, summaries:read 다섯 개를 유지하고 기본 승인 범위는 비워 두세요.
- 생성을 마치고 플러그인을 설치하거나 활성화한 뒤 계정을 연결하세요.
ChatGPT 안내에 따라 개인 플러그인을 만들고 설치 또는 활성화한 뒤 “계정 연결”을 선택하세요. 생성만으로 계정 접근 권한이 부여되지 않으며 앱 내 승인이 필요합니다. 계정, 장부, 수입·지출 생성, 거래 조회, 요약, 쓰기 결과의 여섯 도구는 승인 후 호출을 테스트하세요.
- OAuth를 시작하고 다음 절차에 따라 권한을 승인하세요.
OAuth로 Squirrelly 요청 페이지가 열리면 앱에서 복사한 계정 번호를 입력하세요. 브라우저를 열어 두고 앱에서 접근을 승인하세요.
- 새 채팅을 열고 연결을 활성화하세요.
현재 ChatGPT 화면에 따라 생성한 Squirrelly 플러그인을 활성화하세요. 지원되는 화면에서는
@를 입력해 선택할 수 있습니다. 그다음 아래의 읽기 전용 확인을 실행하세요.
ChatGPT 개인 플러그인에 squirrellyai가 보이면 생성에 성공한 것입니다. 이 플러그인을 설치 또는 활성화하고 Squirrelly 계정을 연결한 뒤 앱 내 승인을 마치고 도구 호출을 테스트하세요. 다시 생성할 필요는 없습니다.
고급: OAuth 엔드포인트와 리디렉션 URI 확인
이 클라이언트에는 현재 아래 리디렉션 URI 하나만 등록되어 있으며, 정확히 일치해야 합니다.
https://chatgpt.com/connector_platform_oauth_redirect호스트에 연결 전용 주소 등 다른 리디렉션 URI가 표시되면 서비스 관리자가 그 정확한 URI를 등록해야 합니다. 와일드카드를 쓰거나 도메인을 임의로 바꾸지 마세요. 다른 에이전트는 별도 클라이언트 등록이 필요하며 이 ChatGPT 클라이언트를 재사용할 수 없습니다. DCR 및 범용 CIMD 등록은 제공되지 않습니다.
자동 검색된 OAuth 엔드포인트 확인
| 설정 | 올바른 값 |
|---|---|
| 승인 URL | https://mcp.squirrelly.ai/oauth/authorize |
| Token URL | https://mcp.squirrelly.ai/oauth/token |
| 승인 서버 기본 URL | https://mcp.squirrelly.ai |
| 리소스 | https://mcp.squirrelly.ai/mcp |
공식 MCP SDK 클라이언트로 실제 서비스를 검증했지만 실제 ChatGPT 계정의 최종 도구 호출은 아직 검증되지 않았습니다. 개인 플러그인 생성 성공이 계정 승인이나 도구 호출 완료, 스토어 등록 또는 OpenAI 심사 통과를 뜻하지는 않습니다.
절차 참고 자료: OpenAI 공식 연결 가이드 · OAuth 인증 안내. 확인 날짜: 2026-10-30.
간편 기록 스킬
명령 하나로 squirrelly 가계부 스킬 설치
컴퓨터 운영체제와 클라이언트에 맞는 명령을 선택해 squirrelly를 자동으로 다운로드하고 설치하세요. MCP 연결과 앱 내 OAuth 승인은 별도로 완료해야 하며, 이후 스킬 단축 명령으로 기록할 수 있습니다.
자동 다운로드 및 설치
해당 명령을 컴퓨터 터미널에 복사하거나 로컬 명령을 실행할 수 있는 에이전트에 전달하세요. 자동으로 다운로드, 검증, 설치하므로 직접 압축을 풀 필요가 없습니다.
macOS
macOS: “터미널”에서 실행하세요. 시스템 기본 도구를 사용하므로 Python이나 Homebrew를 별도로 설치할 필요가 없습니다. 사용하는 클라이언트에 맞는 명령을 선택하세요.
/bin/bash -o pipefail -c 'curl -fsSL --proto =https --proto-redir =https https://mcp.squirrelly.ai/downloads/install-macos.sh | /bin/bash -s -- "$@"' -- --client codex/bin/bash -o pipefail -c 'curl -fsSL --proto =https --proto-redir =https https://mcp.squirrelly.ai/downloads/install-macos.sh | /bin/bash -s -- "$@"' -- --client claude-codeWindows
Windows: PowerShell에서 실행하세요. Windows PowerShell 5.1 및 PowerShell 7을 지원합니다. 사용하는 클라이언트에 맞는 명령을 선택하세요.
& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://mcp.squirrelly.ai/downloads/install-windows.ps1'))) -Client codex& ([scriptblock]::Create((Invoke-RestMethod -Uri 'https://mcp.squirrelly.ai/downloads/install-windows.ps1'))) -Client claude-code설치 프로그램은 SHA-256을 검증하고 스킬 파일만 설치합니다. 다른 기존 내용은 기본적으로 덮어쓰지 않습니다. 업데이트하려면 macOS 명령에 --update, Windows 명령에 -Update를 추가하세요. 먼저 기존 파일을 백업합니다.
설치 후 클라이언트를 다시 로드하거나 새 세션을 시작하세요. Codex는 $squirrelly, Claude Code는 /squirrelly를 사용합니다. 스킬 설치로 MCP 설정이나 OAuth가 자동 완료되지는 않습니다. 서비스를 연결하고 앱에서 별도로 승인해야 합니다.
웹페이지는 로컬 스킬을 자동으로 몰래 설치할 수 없습니다. ChatGPT 웹에서는 플러그인으로 연결하며 위 명령은 로컬 실행 권한이 있는 클라이언트용입니다.
ZIP 수동 다운로드(대체 방법)
클라이언트가 로컬 명령을 지원하지 않으면 지원 범위 내에서 아래 ZIP 가져오기 방법을 사용하세요. 실제 사용 가능 여부는 클라이언트에 따라 다릅니다.
- 스킬 ZIP 수동 다운로드(대체 방법).
squirrelly 스킬 ZIP 다운로드 후 직접 압축을 풀고 INSTALL.md를 읽으세요. 패키지에는 스킬 파일이 포함되며 계정 비밀번호나 토큰은 없습니다.
- 클라이언트의 안내에 따라 설치하세요.
Codex에서는 squirrelly 폴더를 개인 스킬 디렉터리에 넣은 뒤 새 세션에서
$squirrelly를 사용할 수 있습니다. 해당 스킬 디렉터리를 지원하는 클라이언트에서는 자체 안내에 따라/squirrelly를 등록할 수 있습니다. 명령 이름은 클라이언트가 관리하며 MCP가 자동으로 추가하지 않습니다.
먼저 MCP를 연결하고 OAuth 권한 승인을 완료하세요. 스킬은 에이전트의 도구 호출을 안내할 뿐 계정 권한을 제공하지 않습니다. 연결되지 않은 상태에서는 기록하지 않으며, 날짜·통화·장부가 불명확할 때도 임의로 저장하지 않습니다.
/squirrelly 오늘 옷 한 벌을 사고 중국 위안화(CNY)로 2000위안을 썼어요.
현재 ChatGPT에서는 @로 플러그인을 선택할 수 있습니다. 모든 클라이언트에서 슬래시 명령을 사용할 수 있는 것은 아닙니다. 스킬 패키지의 설치 안내에 따라 알맞은 호출 방법을 선택하세요.
단계 02 · 다른 에이전트
같은 서비스에 다른 에이전트 연결하기
사용하는 클라이언트에 맞는 절차 선택
| 사용 환경 | 절차 |
|---|---|
| ChatGPT 웹 | 위 ChatGPT 설정 표에 따라 플러그인을 만들거나 활성화한 다음 계정을 연결하고 App에서 승인하세요. 로컬 스킬을 설치할 필요가 없습니다. |
| Codex | 아래 macOS 또는 Windows 명령으로 스킬을 설치한 뒤 MCP를 별도로 설정하고 App에서 승인하세요. 클라이언트를 다시 로드한 후 $squirrelly를 사용하세요. |
| Claude Code | 아래 macOS 또는 Windows 명령으로 스킬을 설치한 뒤 MCP를 별도로 설정하고 App에서 승인하세요. 클라이언트를 다시 로드한 후 /squirrelly를 사용하세요. |
호스트는 원격 MCP Streamable HTTP 및 OAuth 인증 코드 / PKCE를 지원해야 합니다. 제품마다 설정 위치와 지원 범위가 다르므로 ChatGPT의 화면 절차를 그대로 적용하지 마세요.
- 호스트에서 원격 MCP 또는 도구 서버 설정을 찾으세요.
엔드포인트에
https://mcp.squirrelly.ai/mcp를 입력하고 인증 방식은 OAuth를 선택하세요. - 해당 에이전트 전용 OAuth 클라이언트를 등록하세요.
관리자가 앱 이름, 별도 클라이언트 ID, 호스트가 제공한 정확한 리디렉션 URI를 등록해야 합니다.
squirrelly-chatgpt는 등록된 ChatGPT 리디렉션 전용이므로 다른 제품에서 그대로 사용할 수 없습니다. - 네이티브 앱에서 접근을 승인하세요.
클라이언트 등록 후 아래와 같은 앱 승인 흐름을 따릅니다. 원래 브라우저를 열어 두고 OAuth를 완료하세요. 로컬 stdio, 고정 API 키만 지원하거나 OAuth가 없는 호스트는 직접 연결할 수 없습니다.
개발자는 HTTP API로 자체 에이전트를 연동할 수도 있습니다. 프로토콜 지원은 연동 경로가 있다는 뜻이며 모든 제품의 호환성이 실증되었다는 뜻은 아닙니다.
단계 04
연결을 확인한 뒤 첫 거래 기록하기
아래 순서로 확인하는 것을 권장합니다. 복사 버튼은 텍스트만 복사하며, 자동으로 요청을 제출하거나 거래를 기록하지 않습니다.
Squirrelly로 현재 승인된 계정과 장부를 확인해 주세요. 아직 거래는 기록하지 마세요.
반환된 계정 번호와 장부가 앱의 현재 계정 및 유일한 장부와 일치하는지 확인하세요. 맞다면 실제로 기록하려는 수입이나 지출을 요청하세요.
Squirrelly에 기록해 주세요. 오늘 점심에 중국 위안화(CNY)로 35위안을 썼어요. 현재 승인된 장부에 기록해 주세요.
서비스가 기록 성공을 명시적으로 확인해야 기록이 완료된 것입니다. 그다음 원래 Squirrelly 계정의 해당 장부를 열어 금액, 날짜, 통화를 확인하세요.
연결 후
일상 기록과 조회를 채팅으로
Squirrelly에 기록해 주세요. 오늘 급여로 중국 위안화(CNY) 8000위안을 받았어요.
Squirrelly로 이번 주 지출 내역을 조회하고 최근 20건을 먼저 보여 주세요.
Squirrelly로 이번 달 수입, 지출, 차액을 요약해 주세요. 통화별로 나누어 표시해 주세요.
금액, 통화, 날짜를 명확히 지정하고 현재 승인된 장부를 사용하세요. 첫 출시에서는 에이전트를 통한 기존 거래 수정·삭제, 이체, 대출, 일괄 가져오기를 지원하지 않습니다.
에이전트가 결과를 알 수 없다고 하면 원래 작업 결과를 조회하거나 원래 요청 ID로 재시도하도록 하세요. 새 요청 ID로 같은 거래를 계속 기록하지 마세요. 백엔드는 중복 방지 기록을 사용해 네트워크 재시도로 거래가 중복 생성되는 것을 막습니다.
언제든 직접 관리
권한 취소 또는 계정 변경하기
- 네이티브 앱 설정 → 에이전트 연결을 여세요.
앱에서 승인한 클라이언트를 찾아 장부와 권한을 확인하세요.
- 앱에서 해당 클라이언트의 접근 권한을 철회하세요.
해당 앱은 이후 접근할 수 없습니다. 기존 기록은 보존되고 원래 앱의 로그인과 다른 앱의 권한도 유지됩니다. 앱에서 로그아웃하는 것만으로 에이전트 권한이 취소되지는 않습니다.
- 계정을 바꾸려면 다시 연결하고 승인하세요.
다시 연결하기 전에 네이티브 앱에서 대상 계정으로 로그인하고 요청과 권한을 확인하세요. 해당 계정의 유일한 장부가 자동으로 사용됩니다. 다시 승인해도 기존 거래가 이동하거나 서로 다른 백엔드 계정이 합쳐지지 않습니다.
문제가 생겼을 때
자주 묻는 질문 및 연결 문제 해결
설치 후에도 기록할 수 없는 이유는 무엇인가요?
설치 성공은 스킬 파일이 배치되었다는 뜻입니다. 이 클라이언트 전용 OAuth 클라이언트와 정확한 콜백을 등록하고 MCP에 연결한 후 앱에서 계정, 클라이언트, 권한을 확인하고 명시적으로 승인하세요. 유일한 장부는 자동으로 사용됩니다. 휴대전화 승인 후에도 원래 브라우저를 열어 두고 OAuth를 완료하세요. 다시 로드한 뒤 승인된 계정과 장부를 먼저 조회하고 일치하는지 확인한 후 실제 수입과 지출을 기록하세요.
계정 번호를 입력한 뒤 오류 페이지가 나타나나요?
기존 squirrellyai 플러그인으로 돌아가 “계정 연결”을 다시 시작하세요. 새로 열린 승인 페이지에 계정 번호를 입력하고 이전 오류 페이지만 새로고침하지 마세요. 이번 웹 수정 때문에 휴대폰 앱을 재설치할 필요는 없습니다. 계속 실패하면 페이지에 표시된 오류 코드를 보관하세요.
ChatGPT에 ‘Add custom MCP server’ 메뉴가 없나요?
메뉴 제공 여부는 ChatGPT 계정, 조직, 워크스페이스 정책에 따라 달라집니다. 먼저 현재 공식 안내를 확인하세요. 기업 또는 팀 워크스페이스에서는 관리자에게 사용자 지정 연결 허용 여부를 확인할 수 있습니다. 서비스 URL에 접근할 수 있다고 해서 호스트에서도 해당 메뉴를 제공하는 것은 아닙니다.
주소를 열면 401이 나옵니다. 서비스 오류인가요?
브라우저에서 /mcp에 승인 없이 직접 접근하면 일반적으로 401이 반환됩니다. 에이전트용 엔드포인트이며 로그인 페이지가 아닙니다. 앱 설정 → 에이전트 연결에서 번호를 복사한 뒤 에이전트에서 OAuth를 시작하고 앱에서 승인하세요.
invalid_client 또는 리디렉션 URI 불일치가 표시되나요?
해당 앱의 클라이언트 ID를 입력했는지, 등록된 리디렉션 URI와 정확히 일치하는지 확인하세요. ChatGPT 사전 등록 ID는 squirrelly-chatgpt입니다. 다른 제품은 별도로 등록해야 합니다. 호스트 전용 리디렉션 URI가 등록된 주소와 다르다면 관리자가 설정을 업데이트해야 합니다. 계정을 반복해서 바꾸거나 인증을 끄지 마세요.
에이전트 연결 없음, 계정 불일치 또는 브라우저 대기 중?
설정 → 에이전트 연결이 있는 새 앱이 필요합니다. 없다면 업데이트하거나 기다리세요. 앱에서 원래 계정과 백엔드를 확인하세요. 휴대폰으로 승인하는 동안 원래 브라우저를 열어 두고 그곳에서 OAuth를 완료하세요. 거절 또는 만료되면 새 요청을 시작하세요. Web 계정을 만들거나 Web 비밀번호를 입력하지 마세요.
연결되지만 수입·지출을 생성할 수 없나요?
승인한 권한에 수입·지출 생성이 포함되는지, 장부에 계속 접근할 수 있는지 확인하세요. 요청이 일반 수입 또는 지출이고 금액, 통화, 날짜가 모두 있는지도 확인하세요. 필요하면 다시 연결해 필요한 권한을 명확히 승인하세요.
에이전트는 성공했다고 하는데 앱에서 찾을 수 없나요?
먼저 같은 버전, 계정, 장부인지 확인하고 날짜와 통화 필터를 확인하세요. 에이전트에 원래 작업 결과를 조회하도록 요청하세요. 서비스가 committed(저장 확정)를 반환해야 성공입니다. 결과가 불명확하다면 새 ID로 다시 기록하지 마세요.
연결을 끊으면 기록도 삭제되나요? 중복 방지 기록이란 무엇인가요?
연결 해제는 앱의 접근 권한만 취소하며 거래 기록은 삭제하지 않습니다. 중복 방지 기록은 특정 요청이 어떤 거래로 저장되었는지 보관해 중복 기록을 막습니다. 일반 사용, 로그아웃, 권한 취소로는 지워지지 않습니다. 계정 전체를 삭제할 때만 관련 작업 기록도 계정의 개인정보와 함께 삭제됩니다.
휴대폰이나 서버를 바꾸면 어떻게 되나요?
같은 백엔드 계정의 번호는 유지됩니다. 다른 백엔드의 독립 계정은 각각 별도 번호를 가지며 현재 버전 간 자동 병합은 제공하지 않습니다. 서버 이전 시 플랫폼에서 계정 매핑을 유지해야 하며 같은 이메일 주소만으로 자동 연결할 수는 없습니다.
요청 만료, 권한 철회 또는 일시적 서비스 장애?
만료되거나 거절된 요청은 권한을 부여하지 않습니다. OAuth를 다시 시작하고 앱에서 새 요청을 승인하세요. 권한 철회 시 다시 연결해야 합니다. 일시적 장애는 나중에 재시도하세요. 원래 브라우저를 열어 두고 비밀번호, 인증 코드, 토큰을 채팅에 보내거나 HTTPS 검증을 끄지 마세요.
개발자를 위한 안내
내 에이전트에 기록 기능 연동하기
전용 OAuth 클라이언트와 정확한 리디렉션 URI를 등록하세요. 브라우저가 account_code로 백엔드를 식별하고 네이티브 앱이 요청을 승인하면 원래 브라우저에서 인증 코드 / PKCE S256을 완료한 후 MCP 또는 HTTP API를 호출합니다. 익명 동적 등록, 계정 토큰 공유, 계정 번호만으로 접근하는 방식은 지원하지 않습니다.
| MCP 도구 | 기능 |
|---|---|
get_account / list_books | 승인된 계정과 장부 보기 |
create_transaction | 수입 또는 지출 한 건 생성 |
list_transactions | 거래 내역 페이지별 조회 |
summarize_transactions | 통화별 요약 |
get_operation | 쓰기 결과 조회 |
금액은 통화의 최소 단위를 사용합니다. 생성 작업에는 동일 작업에서 바뀌지 않는 requestId(HTTP에서는 Idempotency-Key)가 필요합니다. committed일 때만 성공으로 보고하고, unknown일 때는 원래 ID를 유지하며 결과를 조회하세요.