AppsAI MCP Server

AppsAI MCP 서버

AI로 풀스택 앱을 빌드하고 배포하세요. 이 MCP 서버는 Claude Code, Cursor, Windsurf 및 기타 AI 도구를 AppsAI 프로젝트에 연결합니다.

지원 스택:

• 프론트엔드: React, Tailwind CSS, shadcn/ui 기반 Next.js
• 백엔드: Parse Server, Express, Fastify, Hono, Supabase Edge Functions, Firebase Cloud Functions, Serverless Framework 또는 커스텀
• 데이터베이스: MongoDB Atlas (관리형)
• 인프라: AWS (S3, CloudFormation, EC2, Lambda 등)

설치

Claude Code

claude mcp add appsai -e APPSAI_API_KEY=your_key -- npx -y @appsai/mcp-server

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "appsai": {
      "command": "npx",
      "args": ["-y", "@appsai/mcp-server"],
      "env": {
        "APPSAI_API_KEY": "your_key"
      }
    }
  }
}

Cursor / Windsurf

MCP 설정에 다음을 추가:

• 명령어: npx -y @appsai/mcp-server
• 환경: APPSAI_API_KEY=your_key

API 키 발급받기

사용자용

1. appsai.com에서 가입
2. 설정 > 결제 > API 키로 이동
3. API 키 생성 클릭
4. 키 복사 (한 번만 표시됨)

AI 에이전트용 (자율 등록)

AI 에이전트는 지갑 기반 인증을 사용하여 프로그래밍 방식으로 등록하고 API 키를 획득할 수 있습니다:

import requests
from eth_account import Account
from eth_account.messages import encode_defunct

# Agent's wallet
private_key = "0x..."
account = Account.from_key(private_key)

BASE_URL = "https://internal.appsai.com/server/functions"
HEADERS = {"Content-Type": "application/json", "X-Parse-Application-Id": "appsai"}

# 1. Get nonce
nonce_data = requests.post(f"{BASE_URL}/getAgentAuthNonce", headers=HEADERS, json={}).json()["result"]

# 2. Sign the message
signed = account.sign_message(encode_defunct(text=nonce_data["message"]))

# 3. Register and get API key
result = requests.post(f"{BASE_URL}/registerAgentWallet", headers=HEADERS, json={
    "walletAddress": account.address,
    "signature": signed.signature.hex(),
    "nonce": nonce_data["nonce"]
}).json()["result"]

api_key = result["apiKey"]  # Use this with MCP

암호화폐로 크레딧 추가

에이전트는 지원 체인(Ethereum, Base, Arbitrum, Polygon)에서 USDC로 크레딧을 결제할 수 있습니다:

# 1. Get payment info
info = requests.post(f"{BASE_URL}/getCryptoPaymentInfo", headers=HEADERS, json={}).json()["result"]
receiving_wallet = info["receivingWallet"]

# 2. Send USDC to receiving_wallet (via your preferred method)

# 3. Verify transaction and add credits
result = requests.post(f"{BASE_URL}/addFundsCrypto", headers=HEADERS, json={
    "walletAddress": account.address,
    "txHash": "0xYOUR_TX_HASH",
    "chainId": 8453  # Base
}).json()["result"]

print(f"Credits added: {result['creditsAdded']}")

자세한 API 문서는 에이전트 API 문서를 참조하세요.

도구 (총 150개 이상)

핵심 개발 도구

카테고리	도구 수	설명
프로젝트	5	프로젝트 생성, 목록 조회 및 관리
캔버스	25	React 컴포넌트, 스타일 및 에셋 편집
백엔드	18	백엔드 코드, S3, CloudFormation 및 AWS 인프라
시스템	11	프론트엔드/백엔드 배포, 앱 연결, MCP 서버 관리
MongoDB	18	데이터베이스 및 컬렉션 관리
에이전트	9	AI 프롬프트 관리 및 버전 관리

플랫폼 관리 도구

카테고리	도구 수	설명
결제	15	구독, 크레딧, 결제, 인보이스
마켓플레이스	12	템플릿 게시, 탐색 및 구매
판매자	5	Stripe Connect, 수익, 판매자 대시보드
도메인	7	서브도메인 및 커스텀 도메인 관리
팀	7	협업자, 권한, 초대
이전	6	프로젝트 소유권 이전
설정	4	프로젝트 표시 설정 및 메타데이터
API 키	3	플랫폼 API 키 관리
비용	6	AWS 비용, 사용량 지표, 예측

시스템 도구

도구	설명
system_DEPLOY_BACKEND	백엔드 인프라 배포
system_DEPLOY_FRONTEND	프론트엔드를 CDN에 배포
system_DEPLOY_ALL	프론트엔드와 백엔드 모두 배포
system_GET_ENVIRONMENT_STATUS	배포 상태 및 URL 조회
system_GET_DEPLOY_ARTIFACTS	배포 아티팩트 및 이력 조회
system_CONNECT_APP	교차 앱 작업을 위해 두 프로젝트 연결
system_DISCONNECT_APP	프로젝트 간 연결 제거
system_ADD_MCP_SERVER	프로젝트에 외부 MCP 서버 추가
system_LIST_MCP_SERVERS	구성된 MCP 서버 목록 조회
system_UPDATE_MCP_SERVER	MCP 서버 구성 업데이트
system_REMOVE_MCP_SERVER	프로젝트에서 MCP 서버 제거

결제 도구

도구	설명
billing_GET_CURRENT_PLAN	구독 플랜 세부 정보 조회
billing_CREATE_CHECKOUT	구독 구매 시작
billing_GET_PORTAL_SESSION	Stripe 결제 포털 열기
billing_ADD_FUNDS	계정에 크레딧 추가
billing_GET_AVAILABLE_CREDITS	현재 크레딧 잔액 조회
billing_GET_INVOICES	인보이스 목록 조회
billing_GET_PAYMENT_METHODS	저장된 결제 수단 목록 조회

마켓플레이스 도구

도구	설명
marketplace_PUBLISH_TEMPLATE	프로젝트를 마켓플레이스에 게시
marketplace_UNPUBLISH_TEMPLATE	마켓플레이스에서 제거
marketplace_GET_TEMPLATES	마켓플레이스 템플릿 탐색
marketplace_GET_TEMPLATE_DETAILS	템플릿 정보 조회
marketplace_FORK_TEMPLATE	템플릿 포크
marketplace_GET_MY_PUBLISHED	사용자가 게시한 템플릿
marketplace_GET_MY_PURCHASES	구매 이력

도메인 도구

도구	설명
domain_CHECK_AVAILABILITY	서브도메인 사용 가능 여부 확인
domain_UPDATE_SUBDOMAIN	프로젝트 서브도메인 업데이트
domain_ADD_CUSTOM_DOMAIN	커스텀 도메인 추가
domain_VERIFY_CUSTOM_DOMAIN	DNS 구성 확인
domain_REMOVE_CUSTOM_DOMAIN	커스텀 도메인 제거

팀 도구

도구	설명
team_GET_COLLABORATORS	프로젝트 협업자 목록 조회
team_INVITE_COLLABORATOR	사용자를 프로젝트에 초대
team_REMOVE_COLLABORATOR	협업자 제거
team_UPDATE_PERMISSIONS	협업자 역할 변경

사용 예시

"List my apps"
→ project_LIST_APPS

"Create a new Next.js app"
→ project_CREATE_APP

"Show the file tree for project abc123"
→ canvas_LIST_FILES

"Deploy the frontend"
→ system_DEPLOY_FRONTEND

"Add an MCP server to my project"
→ system_ADD_MCP_SERVER

"Check my current plan"
→ billing_GET_CURRENT_PLAN

"Publish my project to the marketplace"
→ marketplace_PUBLISH_TEMPLATE

"Add a custom domain"
→ domain_ADD_CUSTOM_DOMAIN

"Invite [email protected] to my project"
→ team_INVITE_COLLABORATOR

MCP 서버 통합

AppsAI 프로젝트는 외부 MCP 서버에 연결하여 AI 에이전트가 추가 도구에 접근할 수 있게 합니다:

"Add the Stripe MCP server to my project"
→ system_ADD_MCP_SERVER with serverUrl and serverLabel

"List my configured MCP servers"
→ system_LIST_MCP_SERVERS

"Disable the Stripe MCP server"
→ system_UPDATE_MCP_SERVER with enabled: false

구성이 완료되면 AppsAI 프로젝트의 AI 에이전트가 연결된 MCP 서버의 도구를 사용할 수 있습니다.

리소스

서버는 프로젝트 컨텍스트를 MCP 리소스로 제공합니다:

• appsai://projects - 프로젝트 목록
• appsai://project/{id} - 프로젝트 세부 정보 및 파일 구조

프롬프트

전체 애플리케이션을 빌드하기 위한 내장 프롬프트:

• build-youtube - 동영상 업로드와 댓글이 가능한 YouTube 클론 빌드
• build-slack - 실시간 메시징이 가능한 Slack 클론 빌드
• build-twitter - 게시물과 팔로우 기능이 있는 Twitter/X 클론 빌드
• connect-apps - 두 개의 AppsAI 프로젝트를 서로 연결

요구 사항

• Node.js 18 이상
• 크레딧이 있는 AppsAI 계정
• 설정 > 결제에서 발급받은 API 키

문서

• AppsAI 문서
• MCP 통합 가이드

지원

• GitHub 이슈
• Discord

라이선스

MIT