Cursor, VS Code, Claude Code에서 Meta Ads MCP 설정 가이드
MCP 주소 하나로 Meta Ads를 Cursor, VS Code, Claude Code에 연결하세요. 편집기별 정확한 설정, 로그인 방식, 광고 변경을 직접 통제하는 방법을 안내합니다.
이 페이지의 내용
원격 MCP 서버 주소 https://teraads.co/mcp 하나를 추가하고 브라우저에서 Tera Ads에 로그인하면 Cursor, VS Code, Claude Code 안에서 Meta Ads를 쓸 수 있습니다. 설치하거나 호스팅할 것은 없습니다. Cursor와 VS Code는 짧은 JSON 항목, Claude Code는 명령어 하나면 되고, 셋 모두 실시간 캠페인과 Shopify 매장의 반품 후 이익을 읽을 수 있습니다. AI가 읽기만 할지, 먼저 물을지, 변경할지는 연결마다 고릅니다.
핵심 요약
- 주소 하나로 세 편집기 모두 작동합니다.
https://teraads.co/mcp는 브라우저 로그인을 쓰는 호스팅 MCP 서버이며 설정에 API 키가 들어가지 않습니다. - Cursor는 모든 프로젝트용
~/.cursor/mcp.json이나 한 프로젝트용.cursor/mcp.json을 읽고, VS Code는 MCP: Add Server나.vscode/mcp.json을 씁니다. - Claude Code는
claude mcp add명령어 하나, 또는 서버와 광고용 스킬 여섯 개를 함께 추가하는 플러그인이 필요합니다. - AI는 29개 도구를 얻습니다. Meta 실시간 조회, 매장의 반품 후 이익, 정해진 한도 안에서의 중지, 켜기, 예산 변경입니다.
- 연결하기 전에 AI가 무엇을 해도 되는지 정하세요. 읽기 전용, 먼저 묻기, 변경 허용 중 하나입니다.
Meta Ads를 코드 편집기에 연결하는 이유
Shopify 테마, 스크립트, 내부 도구를 직접 만든다면 하루를 보내는 곳이 이미 편집기입니다. 거기의 AI 에이전트는 광고 관리자에 다녀오지 않고 광고 질문에 답하고, 답을 저장소의 파일에 쓰고, 방금 바꾼 랜딩 페이지가 최고 성과 광고가 보내는 바로 그 페이지인지 확인할 수 있습니다.
이를 가능하게 하는 개방형 표준이 MCP(Model Context Protocol)입니다. 편집기의 에이전트가 서버가 제공하는 도구를 호출하고, 서버가 광고 플랫폼과 통신합니다. 작동 방식은 MCP 커넥터 이해하기에서 다룹니다. Cursor 문서는 지원 전송 방식으로 stdio, SSE, Streamable HTTP를 나열하고 필요한 서버에는 OAuth를 지원한다고 밝힙니다(Cursor MCP 문서). Claude Code는 /mcp 명령으로 OAuth를 통해 원격 서버에 로그인합니다(Claude Code MCP 문서). 그래서 호스팅 서버는 설정 파일에 키를 붙여 넣을 필요가 없습니다.
Tera Ads Connect가 바로 그런 서버이며 Shopify 브랜드를 위해 만들어졌습니다. Meta 실시간 조회 외에 주문, 반품, 제품 원가, 배송비, 수수료, 환불에서 Meta와 Google 광고비를 뺀 매장의 값으로 답합니다. Meta의 귀속 매출은 Meta의 것으로 표시되므로 AI가 이를 매출로 착각하지 않습니다. 대신 쓸 수 있는 서버 전반을 보고 싶다면 Meta Ads MCP 옵션에서 비교합니다.
시작하기 전에
- 무료 Tera Ads 계정. 가입하고 Meta 광고 계정을 연결하세요. Shopify도 연결해야 AI가 매장 매출과 이익을 볼 수 있습니다.
- 소유자 권한. Tera Ads에서 사업체에 AI를 연결할 수 있는 사람은 사업체 소유자뿐입니다.
- 편집기. Cursor, 채팅 보기가 있는 VS Code, 또는 터미널의 Claude Code.
- 변경에 대한 결정. AI가 보고만 할지, 광고 중지와 예산 변경까지 할지 정하세요. AI 접근 안전 가이드에 복사해 쓸 수 있는 짧은 정책이 있습니다.
다섯 단계로 설정하기
- 무료 Tera Ads 계정을 만듭니다. 가입하고 Meta 광고 계정을 연결한 뒤 Shopify도 연결해 답변에 매장의 반품 후 이익이 포함되게 하세요.
- 편집기에 서버 주소를 추가합니다. Cursor나 VS Code의 MCP 설정에
https://teraads.co/mcp를 붙여 넣거나 Claude Code에서 명령어 하나를 실행하세요. 편집기별 정확한 항목은 아래 섹션에 있습니다. - 브라우저에서 Tera Ads에 로그인합니다. 편집기가 Tera Ads를 열면 로그인하고 공유할 사업체 하나를 고르세요.
- AI가 할 수 있는 일을 고릅니다. 이 연결에 읽기 전용, 먼저 묻기, 변경 허용 중 하나를 고르세요. 뒤의 둘은 나중에 Tera Ads의 AI 연결에서 바꿀 수 있습니다.
- 확인할 수 있는 질문을 합니다. "어제 Meta에 얼마를 썼어?" 같은 질문으로 시작해 더 큰 일을 맡기기 전에 답을 광고 관리자와 대조하세요.

로그인은 PKCE가 있는 OAuth 2.1을 쓰고 서버가 동적 클라이언트 등록을 지원하므로, 편집기가 스스로 등록하며 클라이언트 ID나 시크릿을 다룰 일이 없습니다. Tera Ads는 토큰을 단방향 해시로만 저장합니다. 액세스 토큰은 한 시간 동안 유지되며 자동으로 갱신되고, 연결은 30일 후에 다시 로그인해야 합니다.
Cursor
Cursor는 JSON 파일에서 MCP 서버를 읽습니다. 문서에 따르면 홈 폴더의 ~/.cursor/mcp.json 은 도구를 어디서나 쓰게 하고, 프로젝트 안의 .cursor/mcp.json 은 그 프로젝트로 한정합니다(Cursor MCP 문서). Tera Ads가 GitHub 저장소에 configs/cursor/mcp.json 으로 공개한 것과 같은 이 항목을 추가하세요.
{"mcpServers": {"tera-ads": {"url": "https://teraads.co/mcp"}}}
파일에 이미 다른 서버가 있다면 덮어쓰지 말고 기존 mcpServers 객체 안에 "tera-ads" 항목을 추가하세요. Cursor가 요청하면 브라우저에서 Tera Ads에 로그인합니다. 추가할 API 키나 헤더는 없습니다.
기본적으로 Cursor는 MCP 도구를 쓰기 전에 승인을 요청합니다. 문서에는 묻지 않고 실행되도록 도구를 허용 목록에 넣는 방법도 설명되어 있습니다. 그렇게 한다면 get_insights 와 get_profit 같은 조회 도구만 허용 목록에 넣고, 변경 도구(pause, resume, set_budget, duplicate, 생성 도구)는 확인을 거치게 두세요.
VS Code
VS Code에는 두 가지 방법이 있습니다.
- MCP: Add Server. 명령 팔레트를 열고 MCP: Add Server를 실행해 HTTP를 고르고
https://teraads.co/mcp를 붙여 넣은 뒤 서버 ID를tera-ads로 지정하세요. - 워크스페이스 파일. 저장소의
configs/vscode/mcp.json항목을.vscode/mcp.json에 추가하세요.{"servers": {"tera-ads": {"type": "http", "url": "https://teraads.co/mcp"}}}. VS Code는 Cursor의mcpServers대신servers를 쓰므로 한 편집기의 파일을 다른 쪽에 복사하지 마세요.
VS Code의 MCP 문서는 이제 새 설정을 안내형 흐름으로 이끌며 워크스페이스의 .vscode/mcp.json 파일은 호환성을 위해 계속 쓸 수 있다고 하므로 어느 쪽이든 됩니다. 서버를 시작하고, VS Code가 요청하면 Tera Ads에 로그인한 뒤, 채팅 입력창의 Configure Tools에서 Tera Ads를 켜세요. VS Code 문서는 이해하는 작업만 승인하라고 조언하는데, 예산을 건드리는 요청에는 맞는 습관입니다.
Claude Code
명령어 하나로 서버를 추가합니다.
claude mcp add --transport http tera-ads https://teraads.co/mcp
Claude Code를 시작하고 /mcp 를 입력해 tera-ads를 선택한 뒤 브라우저에서 Tera Ads에 로그인하세요. Claude Code 문서에 따르면 /mcp 가 OAuth 로그인을 실행하고 토큰은 자동으로 저장되고 갱신되며, claude mcp list 로 각 서버가 연결되었는지 인증이 필요한지 볼 수 있습니다.
서버는 기본적으로 로컬 범위로 추가됩니다. 나만, 현재 프로젝트에서만 쓸 수 있습니다. 모든 프로젝트에서 쓰려면 --scope user 를, 버전 관리로 공유하는 .mcp.json 파일에 쓰려면 --scope project 를 추가하세요. 공유 파일은 주소만 공유합니다. 각자 따로 로그인하며, Tera Ads 사업체에 AI를 연결할 수 있는 사람은 사업체 소유자뿐입니다.
스킬 여섯 개가 있는 플러그인
서버와 함께 바로 쓸 수 있는 워크플로를 추가하려면 대신 Tera Ads를 플러그인으로 설치하세요. claude plugin marketplace add Teralabsx/meta-ads-mcp 를 실행한 다음 claude plugin install tera-ads@tera-ads 를 실행합니다. Claude Code의 플러그인 문서에 따르면 플러그인은 스킬, 에이전트, 훅, MCP 서버를 추가하고 스킬은 /<plugin>:<skill> 형태로 나타나므로 아래 첫 번째는 /tera-ads:profit-check 입니다.
| 스킬 | 하는 일 |
|---|---|
profit-check | Meta의 숫자를 매장의 반품 후 이익 옆에 놓습니다 |
weekly-ads-review | 이번 주를 지난주와 비교해 변경을 제안하며, 직접 변경하지는 않습니다 |
pause-wasted-spend | 판매 없이 돈을 쓰는 광고를 찾아 고른 것을 중지합니다 |
scale-a-winner | 잘되는 광고의 예산을 안전한 단계로 올리거나 중지 상태 초안으로 복사합니다 |
launch-paused-campaign | 캠페인, 광고 세트, 광고를 모두 중지 상태로 만들어 확인하게 합니다 |
refresh-ad-copy | 지친 광고의 새 버전을 옆에 중지 상태 광고로 작성합니다 |
같은 문서에 따르면 제3자 마켓플레이스의 플러그인은 기본적으로 자동 업데이트되지 않습니다. 새 버전을 받으려면 claude plugin update tera-ads@tera-ads 를 실행하세요.
세 편집기 나란히 보기
| Cursor | VS Code | Claude Code | |
|---|---|---|---|
| 설정을 넣는 곳 | ~/.cursor/mcp.json 또는 .cursor/mcp.json | MCP: Add Server 또는 .vscode/mcp.json | claude mcp add, 로컬, 사용자, 프로젝트 범위 |
| 항목 형식 | url 이 있는 mcpServers | "type": "http" 와 url 이 있는 servers | 명령어 하나, 편집할 파일 없음 |
| 로그인 | Cursor가 요청할 때 브라우저 | 서버를 시작한 뒤 브라우저 | /mcp, 그다음 브라우저 |
| 처음 쓰기 전 | 추가 작업 없음 | Configure Tools에서 켜기 | 추가 작업 없음 |
| 추가 기능 | 없음 | 없음 | 스킬 여섯 개가 있는 플러그인 |
| 편집기 문서 | Cursor | VS Code | Claude Code |
먼저 무엇을 물을까
광고 관리자에서 1분 만에 확인할 수 있는 질문으로 시작하세요. 숫자가 맞으면 매장 데이터가 필요한 질문으로 넘어가세요. 광고 분석 프롬프트 모음과 광고에 대해 AI에게 물어볼 질문에 더 많은 예가 있습니다.
| 질문 | AI가 조회하는 것 |
|---|---|
| "이번 주에 가장 많이 쓴 캠페인은 어디고 얼마를 벌어 왔어?" | get_insights |
| "최근 30일의 반품 후 이익은 얼마였어?" | get_profit |
| "Meta는 내 ROAS가 3이라는데, 내 매장은 실제로 얼마를 벌었어?" | get_insights, get_profit |
| "반품 후 손해 보는 캠페인은 어디고 어떻게 해야 해?" | get_ads_review |
| "최근 14일 동안 판매 없이 돈을 쓴 광고는 뭐야?" | 광고 단위의 get_insights |
| "이번 주에 내 광고에서 뭐가 바뀌었고 아직 되돌릴 수 있어?" | list_recent_changes |
답변을 읽을 때 두 가지를 기억하세요. 첫째, Meta의 구매와 매출은 Meta의 귀속이지 매장의 매출이 아닙니다. 그 차이는 Meta 광고와 Shopify가 다른 이유에서 설명합니다. 둘째, get_ads_review 는 광고비를 쓴 모든 캠페인을 매장의 평소 반품과 사용자의 비용을 반영한 이익으로, 사용자의 손익분기 ROAS와 비교해 판단합니다. 이익 자체는 설정한 마진으로 주문에서 계산한 매장 전체의 추정치이며 은행에 있는 현금이 아닙니다.
광고 변경을 직접 통제하세요
변경은 두 곳에서 통제됩니다. 도구가 실행되기 전에 물을 수 있는 편집기, 그리고 연결이 무엇을 할 수 있는지 아예 정하는 Tera Ads입니다.
- 읽기 전용, 먼저 묻기, 변경 허용. 먼저 묻기에서는 변경이 Tera Ads에서 사용자가 승인할 때까지 대기하며, AI가 대신 승인할 수 없습니다.
- 새 항목은 중지 상태로 시작합니다. 캠페인, 광고 세트, 광고, 복사본은 누가 켤 때까지 돈을 쓰지 않습니다.
- 예산 단계에 상한이 있습니다. 변경 한 번은 예산을 최대 세 배로 올리거나 10분의 1로 줄이는 데 그칩니다.
- 하루 상한. 어시스턴트는 사업체 하나에 하루 최대 50번 변경할 수 있습니다.
- 삭제 도구 없음. AI는 중지할 수 있지만 아무것도 삭제할 수 없습니다.
- 7일 동안 되돌리기. 중지, 켜기, 예산 변경은 Tera Ads에서 7일 동안 되돌릴 수 있습니다. 새 캠페인, 광고 세트, 광고는 되돌릴 수 없지만 중지 상태로 시작합니다.
- 연결당 사업체 하나. 연결은 다른 사업체를 읽을 수 없으며, 같은 사람이 소유한 사업체여도 마찬가지입니다.

캠페인 이름과 광고 문구는 데이터로 AI에 전달되며 Tera Ads는 그 안의 지시를 따르지 말라고 AI에 알려 줍니다. Claude Code 문서도 일반적인 점을 짚습니다. 외부 콘텐츠를 가져오는 서버는 프롬프트 인젝션에 노출될 수 있으므로 신뢰하는 서버만 연결하라는 것입니다. 모든 변경을 일어나기 전에 보고 싶다면 먼저 묻기를 고르세요.
작동하지 않을 때
서버가 로그인이 필요하다고 합니다. Claude Code에서는 /mcp 를 실행해 tera-ads를 선택하세요. 하기 전에는 claude mcp list 에 인증이 필요하다고 나옵니다. Cursor와 VS Code에서는 서버를 다시 시작하고 브라우저 로그인을 마치세요.
VS Code 채팅에 도구가 보이지 않습니다. 채팅 입력창의 Configure Tools를 열고 Tera Ads를 켜세요.
AI가 한도에 도달했다고 합니다. 무료 요금제는 주 30회 호출이며 UTC 기준으로 매주 초기화됩니다. AI에게 무료이며 남은 호출 수와 초기화 시각을 알려 주는 get_usage 를 실행하게 하세요.
예산이 백 배 크게 보입니다. list_campaigns 는 예산을 Meta의 단위로 보여 주며 대부분의 통화에서 100분의 1 단위이므로 5000은 $50입니다. set_budget 은 계정 통화의 정수 단위를 받습니다.
다른 매장에 대한 답이 나옵니다. 연결 하나는 사업체 하나를 다룹니다. 다시 연결해서 다른 사업체를 고르세요.
Tera Ads Connect는 Shopify 브랜드를 위한 수익 대시보드 Tera Ads의 MCP 서버입니다. 편집기에 Meta 실시간 조회, Shopify 매출과 반품 후 이익, 한도가 있고 기록되는 광고 변경을 제공합니다. 무료 요금제는 Meta 광고 계정 하나에서 주 30회 호출을 포함하고, Connect Pro는 월 $15에 최대 광고 계정 세 개에서 월 3,000회 호출이며 Growth와 Scale 요금제에 포함됩니다. 모든 클라이언트의 설정 단계는 Connect 페이지에 있습니다.
자주 묻는 질문
Meta Ads MCP가 Cursor에서 작동하나요?
네. Cursor는 OAuth 로그인이 있는 원격 MCP 서버를 지원합니다. ~/.cursor/mcp.json 이나 .cursor/mcp.json 에 Tera Ads 항목을 추가하고, Cursor가 요청하면 Tera Ads에 로그인하세요.
VS Code에 Meta Ads MCP를 추가하려면 어떻게 하나요?
MCP: Add Server를 실행해 HTTP를 고르고 https://teraads.co/mcp 를 붙여 넣거나, .vscode/mcp.json 에 항목을 추가하세요. 서버를 시작하고, 로그인한 뒤, 채팅의 Configure Tools에서 Tera Ads를 켜세요.
Meta Ads MCP의 Claude Code 명령어는 무엇인가요?
claude mcp add --transport http tera-ads https://teraads.co/mcp 입니다. 그런 다음 Claude Code에서 /mcp 를 입력하고 로그인하세요. 바로 쓸 수 있는 광고 스킬 여섯 개가 필요하면 claude plugin marketplace add Teralabsx/meta-ads-mcp 와 claude plugin install tera-ads@tera-ads 로 플러그인을 설치하세요.
API 키나 Meta 개발자 앱이 필요한가요?
아니요. 브라우저에서 Tera Ads에 로그인하고, 변경은 Tera Ads의 승인된 Meta 앱을 통해 Meta에 전달됩니다. 설정 파일에 비밀 값은 들어가지 않습니다.
편집기의 AI가 내 광고를 바꿀 수 있나요?
그 연결에 허용했을 때만 가능합니다. 허용해도 새 항목은 중지 상태로 시작하고, 예산 변경 한 번은 최대 세 배 또는 10분의 1이며, 중지, 켜기, 예산 변경은 Tera Ads에서 7일 동안 되돌릴 수 있습니다.
비용은 얼마인가요?
무료 요금제는 Meta 광고 계정 하나에서 주 30회 호출을 포함합니다. Connect Pro는 월 $15에 월 3,000회 호출입니다. 호출은 AI가 Tera Ads에서 하는 조회 한 번이며 질문 하나에 몇 번 필요할 수 있습니다.