개발자 및 Agent 리소스
StarVeil AI MCP Server 및 Agent 연동
StarVeil AI는 사용자 승인 기반 Model Context Protocol(MCP) Server를 제공합니다. Agent는 연결된 사용자 신원으로 동작하며 해당 사용자의 캐릭터, 크레딧, 생성 작업과 다운로드 가능한 자산에만 접근합니다.
MCP endpoint와 자동 검색
아래 Streamable HTTP MCP endpoint를 사용합니다. OAuth resource metadata와 authorization server metadata가 표준 well-known URL에 공개되어 호환 클라이언트가 인증 절차를 자동 검색할 수 있습니다.
OAuth resource metadata
https://starveilai.com/.well-known/oauth-protected-resource/api/mcpAuthorization server metadata
https://starveilai.com/.well-known/oauth-authorization-server/api/auth인증
OAuth 인증을 사용합니다. 클라이언트는 필요한 scope만 요청하고 사용자 동의를 받은 뒤 bearer token을 MCP endpoint로 전송해야 합니다. 내부 Render API와 자격 증명은 공개 연동 대상이 아닙니다.
공개 OAuth scopes
openidprofileoffline_accesscharacters:readcomics:readcomics:createassets:download사용 가능한 MCP tools
계정 및 크레딧 확인, 재사용 캐릭터 검색, 공식 템플릿 검색, 단편 만화 생성, 생성 상태 확인과 결과 조회 기능을 제공합니다.
get_meget_credit_balancelist_my_characterslist_short_comic_templatescreate_short_comicget_generation_statusget_short_comic_result접근 및 안전 경계
모든 작업은 승인된 StarVeil 계정에 제한됩니다. 다른 사용자의 캐릭터나 자산을 읽을 수 없습니다. 생성 작업은 웹 앱과 동일한 크레딧, 소유권, 검증 및 저장 경계를 사용합니다.
연동 시작
MCP 클라이언트에 아래 endpoint를 설정하세요. protected-resource discovery를 지원하는 클라이언트는 MCP URL에서 공개 OAuth metadata를 따라 연결할 수 있습니다.
https://starveilai.com/api/mcp