Skip to main content
Flespi 계정을 연결하여 CloudThinker 에이전트가 Flespi MCP 서버를 통해 GPS 디바이스를 관리하고, 텔레메트리를 모니터링하며, 채널과 스트림을 검사하고, 차량 인프라를 운영할 수 있도록 합니다. Flespi는 Flespi 패널에서 생성된 API 토큰(Standard 또는 ACL 유형)으로 인증합니다.

​
지원 플랫폼

​
사전 요구 사항

  • flespi.io의 Flespi 계정.
  • API 토큰을 생성하고 관리하기 위한 Flespi 패널 접근 권한.
  • 프로덕션 워크로드의 경우, CloudThinker가 필요한 모듈로 권한이 범위 지정된 ACL 토큰.

​
설정

CloudThinker는 Flespi API 토큰을 사용하여 공식 MCP 서버를 통해 Flespi에 연결합니다.
1

Flespi 계정 생성

계정이 없는 경우 flespi.io에서 가입합니다.
2

API 토큰 생성

Flespi 패널의 왼쪽 메뉴에서 Tokens로 이동하여 ”+” 버튼을 클릭합니다:
  • Name: CloudThinker Agent
  • Type: Standard (개발) 또는 ACL (프로덕션)
  • TTL: 만료 설정 — 예: 7776000 (90일). Flespi는 모든 토큰에 TTL 또는 만료 날짜를 요구합니다.
64바이트 토큰을 즉시 복사합니다.
3

CloudThinker에 연결 추가

Connections → Flespi로 이동하여 방금 생성한 토큰을 입력합니다.
4

연결 테스트

Connect를 클릭합니다. CloudThinker가 토큰을 확인하고 Connected 상태를 표시합니다.
Flespi는 Bearer 대신 FlespiToken을 인증 접두사로 사용합니다. CloudThinker가 이를 자동으로 처리하지만, API 호출을 수동으로 디버깅할 때 참고하세요.

​
연결 세부 정보

​
필요 권한

​
토큰 유형

​
토큰 만료

Flespi는 모든 토큰이 만료되도록 요구합니다. 다음 중 하나 이상을 설정하세요:
  • ttl — 비활성 상태 후 만료까지의 초 (API 호출 시마다 재설정)
  • expire — 하드 만료의 Unix 타임스탬프
장기 실행 통합의 경우 ttl을 사용하세요 (예: 7776000 = 90일). 타이머는 모든 API 호출 시 재설정되므로 활성 토큰이 예기치 않게 만료되지 않습니다.

​
권장 ACL 권한 (프로덕션)

읽기 전용 (최소): 읽기-쓰기 (쓰기 작업이 필요한 경우):
ACL 토큰은 기본적으로 모든 것을 거부합니다. 명시적으로 부여된 권한만 허용됩니다. gw/devices에 POST 권한이 있는 토큰은 GET 권한도 명시적으로 부여하지 않으면 GET이 불가합니다.

​
에이전트 기능

연결 후 에이전트는 다음을 수행할 수 있습니다:

​
사용 가능한 MCP 도구

무료 도구 (0 크레딧): 유료 도구:

​
AI 크레딧

flespi 패널의 AI 타일, GET /ai/logs API, 또는 MQTT 토픽 flespi/log/ai/#을 통해 사용량을 모니터링하세요.

​
연결 확인

​
예시 프롬프트

​
문제 해결

  • 토큰이 만료되었을 수 있습니다 — flespi 패널에서 TTL 및 만료 설정을 확인하세요.
  • 새 토큰을 생성하고 CloudThinker에서 연결을 업데이트합니다.
  • 만료된 토큰은 flespi에 의해 자동으로 삭제됩니다.
  • ACL 토큰에 필요한 모듈 + HTTP 메서드 조합이 없습니다.
  • 필요한 권한을 부여하도록 토큰 ACL을 업데이트합니다.
  • 기억하세요: ACL은 기본적으로 모두 거부 — 각 권한은 명시적으로 부여해야 합니다.
  • 월간 AI 크레딧이 소진되었습니다.
  • Free 플랜: 다음 달까지 기다립니다. Commercial 플랜: 초과 사용 설정을 확인합니다.
  • GET /ai/logs 또는 이벤트 코드 1710을 통해 크레딧 사용량을 모니터링합니다.
  • flespi는 분당 API + MQTT + 트래픽 사용량을 통합 계산합니다.
  • 요청 빈도를 줄이거나 작업을 일괄 처리합니다.
  • 사용량이 가장 많은 토큰이 먼저 차단되고, 다른 토큰은 계속 작동합니다.
  • 토큰에 IP 화이트리스트가 구성되어 있지만 서버 IP가 포함되어 있지 않습니다.
  • flespi 패널에서 토큰의 IP 화이트리스트를 업데이트합니다: Token settings → IPs whitelist.

​
보안

  • 최소 권한 — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
  • 기본 읽기 전용 — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
  • 자격증명 교체 — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
  • 오프보딩 시 취소 — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.
  • 전용 토큰 — CloudThinker 전용 토큰을 생성하고, 통합 간에 공유하거나 Master 토큰을 사용하지 마세요.
  • 프로덕션에 ACL 사용 — 최소 필요 권한만 있는 ACL 토큰을 사용하고, ACL 토큰은 기본적으로 모두 거부임을 기억하세요.

​
관련 항목

MCP 연결

커스텀 MCP 통합

Kubernetes 연결

IoT 워크로드를 위한 컨테이너 오케스트레이션