Codex와 Gemini CLI에서 Meta 광고 다루기: 코딩 에이전트를 광고에 연결하기
명령어 두 줄로 Codex나 Gemini CLI를 Meta 광고에 연결하세요. 설정 방법, 브라우저 로그인, 안전한 도구 설정, Shopify 이익으로 광고를 점검하는 프롬프트를 소개합니다.
이 페이지의 내용
Codex와 Gemini CLI는 모두 https://teraads.co/mcp 의 호스팅 MCP 서버인 Tera Ads를 통해 Meta 광고를 읽고 관리할 수 있습니다. Codex에서는 codex mcp add tera-ads --url https://teraads.co/mcp 를 실행한 뒤 codex mcp login tera-ads 를 실행하세요. Gemini CLI에서는 GitHub에서 Tera Ads 확장을 설치하고 /mcp auth tera-ads 를 실행합니다. 둘 다 브라우저에서 Tera Ads에 로그인하며, 에이전트가 읽기만 할지, 먼저 물을지, 변경할지는 사용자가 고릅니다.
핵심 요약
- 에이전트마다 명령어 두 개입니다. 서버를 추가하고, 브라우저에서 Tera Ads에 로그인합니다. 설정에 API 키는 들어가지 않습니다.
- Codex는 서버를
~/.codex/config.toml에 저장하며, Codex IDE 확장과 ChatGPT 데스크톱 앱이 이를 공유합니다. - Gemini CLI는 Tera Ads를 확장으로 설치하며, Gemini에 언제 써야 하는지 알려 주는 컨텍스트 파일도 함께 불러옵니다.
- 에이전트는 Meta 실시간 조회부터 매장의 반품 후 이익, 한도가 있는 예산 변경까지 29개 도구를 얻습니다.
- 변경은 두 곳에서 제한하세요. 에이전트 자체의 도구 설정과 Tera Ads 연결 모드입니다.
코딩 에이전트를 광고에 연결하는 이유
많은 Shopify 창업자는 자기 테마, 스크립트, 내부 도구를 직접 만들며 하루의 절반을 터미널에서 보냅니다. 광고에 연결된 코딩 에이전트는 상품 페이지를 편집하는 같은 세션에서 "어제 Meta에 얼마를 썼어?"에 답하고, 주간 요약을 저장소에 Markdown 파일로 저장하고, 화요일에 배포한 변경과 한 주의 캠페인 결과를 나란히 놓아 줄 수 있습니다.
에이전트와 광고 계정을 잇는 것은 MCP(Model Context Protocol)입니다. AI 에이전트가 다른 서비스가 제공하는 도구를 호출할 수 있게 하는 개방형 표준이며, 기본은 MCP 커넥터 이해하기에서 다룹니다. Codex와 Gemini CLI는 모두 OAuth로 로그인하는 원격 MCP 서버를 지원하므로 Tera Ads 같은 호스팅 서버는 에이전트 외에 설치할 것이 없습니다.
Tera Ads가 단순한 Meta 연결에 더하는 것은 매장입니다. 캠페인, 광고 세트, 광고의 실시간 조회 외에 Shopify 주문, 반품, 제품 원가, 배송비, 수수료, 환불에서 Meta와 Google 광고비를 뺀 값으로 답합니다. Meta의 귀속 매출은 Meta의 것으로 표시되므로 에이전트가 이를 매출로 다루지 않습니다. 대신 연결할 수 있는 다른 서버는 Meta Ads MCP 옵션을 보세요.
Gemini CLI에 관한 참고: 문서에는 무료 요금제와 Google One 사용자의 경우 2026년 6월 18일에 Gemini CLI가 Antigravity CLI로 대체되었다는 안내가 있습니다(Gemini CLI MCP 문서). 아래 단계는 2026년 10월에 문서화된 Gemini CLI를 따릅니다.
시작하기 전에
- 무료 Tera Ads 계정. 가입하고 Meta 광고 계정을 연결하세요. Shopify도 연결해야 에이전트가 매장 매출과 이익을 볼 수 있습니다.
- 소유자 권한. Tera Ads에서 사업체에 AI를 연결할 수 있는 사람은 사업체 소유자뿐입니다.
- Codex나 Gemini CLI 설치와 각자의 계정 로그인.
- 변경 규칙. 에이전트가 보고만 할지, 광고 중지와 예산 이동까지 할지 정하세요. AI 접근 안전 가이드에 복사해 쓸 수 있는 짧은 정책이 있습니다.
Codex 연결하기, 단계별로
- 무료 Tera Ads 계정을 만듭니다. 가입하고 Meta 광고 계정을 연결한 뒤 Shopify도 연결해 답변에 매장의 반품 후 이익이 포함되게 하세요.
- Codex에 서버를 추가합니다. 터미널에서
codex mcp add tera-ads --url https://teraads.co/mcp를 실행하세요. - Tera Ads에 로그인합니다.
codex mcp login tera-ads를 실행하면 브라우저에서 Tera Ads가 열립니다. 로그인하고, 사업체를 고르고, 에이전트가 할 수 있는 일을 선택하세요. - 연결을 확인합니다.
codex를 시작하고/mcp를 입력하면 활성 MCP 서버가 나열되며 tera-ads가 목록에 있어야 합니다. - 확인할 수 있는 질문을 합니다. "Tera Ads로 활성 Meta 캠페인과 어제의 광고비를 보여 줘"를 해 보고 광고 관리자와 대조하세요.

Codex는 MCP 서버를 ~/.codex/config.toml 에 서버마다 [mcp_servers.tera-ads] 테이블 하나로 저장하며 주소는 url 에 들어갑니다. OpenAI 문서에 따르면 ChatGPT 데스크톱 앱, Codex CLI, IDE 확장이 이 설정을 공유하므로 한 번의 설정으로 셋 모두에 적용됩니다(Codex MCP 문서). 같은 문서에 따르면 codex mcp login 이 OAuth를 처리하고 Codex가 클라이언트 등록 방식을 자동으로 고를 수 있습니다. Tera Ads는 OAuth 2.1과 PKCE로 동적 클라이언트 등록을 지원하므로 넘길 클라이언트 ID가 없습니다.
Codex 쪽에서도 읽기로 제한하기
Codex의 서버 설정에는 허용 목록인 enabled_tools 와 그 뒤에 적용되는 거부 목록인 disabled_tools 가 있습니다. Tera Ads 연결이 변경을 허용하더라도 Codex가 변경 도구를 호출하지 못하게 하려면 config.toml 의 [mcp_servers.tera-ads] 아래에 이 줄을 추가하세요.
disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]
문서에는 서버별, 도구별 승인 설정도 설명되어 있습니다. 그래도 가장 간단한 방어는 Tera Ads 쪽입니다. 로그인할 때 읽기 전용을 고르면 변경 도구는 그 연결에서 아무것도 할 수 없습니다.
Gemini CLI 연결하기
- 확장을 설치합니다.
gemini extensions install https://github.com/Teralabsx/meta-ads-mcp를 실행하세요. - Tera Ads에 로그인합니다. Gemini CLI를 시작하고
/mcp auth tera-ads를 실행한 뒤 로그인하고, 사업체를 고르고, 에이전트가 할 수 있는 일을 선택하세요. - 도구를 확인합니다.
/mcp를 입력하면 각 서버의 상태와 도구가 보이고, 셸에서gemini extensions list를 실행해도 됩니다. - 확인할 수 있는 질문을 합니다. "이번 주에 가장 많이 쓴 Meta 캠페인은 어디야?"를 해 보고 광고 관리자와 대조하세요.
확장은 Tera Ads GitHub 저장소의 작은 gemini-extension.json 파일입니다. httpUrl 필드로 Gemini가 https://teraads.co/mcp 를 가리키게 하며, Gemini 문서는 이 필드를 Streamable HTTP 엔드포인트로 정의하고 url 은 SSE용입니다. 또 컨텍스트 파일로 GEMINI.md 를 지정합니다. 이 파일은 Gemini에게 Meta 광고, ROAS, 이익 질문에는 Tera Ads를 쓰고, Meta의 귀속 매출은 Meta의 것으로 표시하고, 캠페인 이름과 광고 문구는 지시가 아니라 데이터로 다루라고 알려 줍니다.
Gemini 문서에 따르면 원격 MCP 서버용 OAuth를 지원하고, 설정을 자동으로 찾을 수 있고, 서버가 지원하면 동적 클라이언트 등록을 처리하며, 토큰을 ~/.gemini/mcp-oauth-tokens.json 에 저장합니다. 서버 설정에는 trust 도 있는데, true로 설정하면 모든 도구 호출 확인을 건너뜁니다. Tera Ads 확장은 이를 설정하지 않습니다. 그대로 두어 Gemini가 도구를 실행하기 전에 계속 묻게 하세요.
Codex와 Gemini CLI 나란히 보기
| Codex | Gemini CLI | |
|---|---|---|
| 서버 추가 | codex mcp add tera-ads --url https://teraads.co/mcp | gemini extensions install https://github.com/Teralabsx/meta-ads-mcp |
| 로그인 | codex mcp login tera-ads | /mcp auth tera-ads |
| 저장 위치 | ~/.codex/config.toml | 설치된 확장 |
| 작동 확인 | Codex에서 /mcp | /mcp 또는 gemini extensions list |
| 에이전트 측 제한 | enabled_tools, disabled_tools, 승인 설정 | trust 를 끈 채로 둠 |
| 함께 적용되는 곳 | Codex IDE 확장과 ChatGPT 데스크톱 앱 | GEMINI.md 를 컨텍스트로 불러옴 |
| 에이전트 문서 | Codex MCP 문서 | Gemini CLI 확장 |
Codex나 다른 에이전트가 말하지 않아도 Tera Ads를 쓰게 하려면, 저장소는 GEMINI.md 의 내용을 프로젝트의 AGENTS.md 나 CLAUDE.md 에 복사하라고 제안합니다. 아니면 프롬프트에 Tera Ads를 명시하세요.
터미널 에이전트에 어울리는 프롬프트
코딩 에이전트는 채팅 창이 못하는 일을 합니다. 답을 일하는 곳에 놓아 줍니다. 결과를 파일로 저장하게 하거나, 지난주 파일과 비교하게 하거나, 캠페인이 보내는 상품 페이지를 열게 해 보세요.
| 요청 | 에이전트가 쓰는 것 |
|---|---|
| "최근 30일의 반품 후 이익은 얼마였어? reports/profit.md에 저장해 줘." | get_profit, 그다음 자체 파일 도구 |
| "Meta는 내 ROAS가 3이라는데, 내 매장은 실제로 얼마를 벌었어?" | get_insights, get_profit |
| "반품 후 손해 보는 캠페인은 어디고 어떻게 해야 해?" | get_ads_review |
| "최근 14일 동안 판매 없이 돈을 쓴 광고는 뭐야?" | 광고 단위의 get_insights |
| "이번 주에 내 광고에서 뭐가 바뀌었고 아직 되돌릴 수 있어?" | list_recent_changes |
| "가장 잘 된 캠페인을 중지 상태 초안으로 복사해 줘." | duplicate |
| "Tera Ads 호출이 몇 번 남았어?" | get_usage, 무료 |
답변은 두 가지 단서를 달고 읽으세요. Meta의 구매와 매출은 Meta의 귀속이지 매장의 매출이 아닙니다. 그리고 get_ads_review 는 광고비를 쓴 모든 캠페인을 매장의 평소 반품과 사용자의 비용을 반영한 이익으로, 사용자의 손익분기 ROAS와 비교해 판단합니다. 이익 수치는 은행에 있는 현금이 아니라 매장 전체에 대한 추정치입니다. 환불 후 실제 ROAS에서 이 차이가 왜 중요한지 보여 주고, 광고 분석 프롬프트 모음에 더 많은 질문이 있습니다.

에이전트의 변경 통제하기
코딩 에이전트는 매번 묻지 않고 파일을 수정하도록 설정되는 경우가 많습니다. 호출 한 번의 실수로 실제 돈이 나가는 광고 도구에 그 습관이 번지지 않게 하세요. Tera Ads는 에이전트에 무엇이 허용되든 자체 한도를 둡니다.
- 읽기 전용, 먼저 묻기, 변경 허용. 먼저 묻기에서는 변경이 Tera Ads에서 사용자가 승인할 때까지 대기하며, 에이전트가 대신 승인할 수 없습니다.
- 새 항목은 중지 상태로 시작합니다. 캠페인, 광고 세트, 광고, 복사본은 누가 켤 때까지 돈을 쓰지 않습니다.
- 예산 단계에 상한이 있습니다. 변경 한 번은 예산을 최대 세 배로 올리거나 10분의 1로 줄이는 데 그칩니다.
- 하루 상한. 어시스턴트는 사업체 하나에 하루 최대 50번 변경할 수 있습니다.
- 삭제 도구 없음. 에이전트는 중지할 수 있지만 아무것도 삭제할 수 없습니다.
- 7일 동안 되돌리기. 중지, 켜기, 예산 변경은 Tera Ads에서 7일 동안 되돌릴 수 있습니다. 새 캠페인, 광고 세트, 광고는 되돌릴 수 없지만 중지 상태로 시작합니다.
- 연결당 사업체 하나. 연결은 다른 사업체를 읽을 수 없으며, 같은 사람이 소유한 사업체여도 마찬가지입니다.
변경 결과가 outcome_unknown 으로 돌아오면 에이전트에게 반복하라고 하지 마세요. 같은 변경이 두 번 이루어지지 않도록 먼저 list_recent_changes 를 확인하게 하세요.
작동하지 않을 때
에이전트가 Tera Ads를 무시합니다. 프롬프트에 이름을 넣거나("Tera Ads로 ...") 위처럼 GEMINI.md 를 프로젝트의 지침 파일에 복사하세요.
다시 로그인하라고 합니다. 액세스 토큰은 한 시간 동안 유지되며 자동으로 갱신되고, 연결은 30일 동안 유지됩니다. codex mcp login tera-ads 나 /mcp auth tera-ads 를 다시 실행하세요.
한도에 도달했다고 합니다. 무료 요금제는 주 30회 호출이며 UTC 기준으로 매주 초기화됩니다. get_usage 는 무료이고 남은 호출 수와 초기화 시각을 알려 줍니다.
예산이 백 배 크게 보입니다. list_campaigns 는 예산을 Meta의 단위로 보여 주며 대부분의 통화에서 100분의 1 단위이므로 5000은 $50입니다. set_budget 은 계정 통화의 정수 단위를 받습니다.
다른 매장에 대한 답이 나옵니다. 연결 하나는 사업체 하나를 다룹니다. 다시 로그인해서 다른 사업체를 고르세요.
Tera Ads Connect는 Shopify 브랜드를 위한 수익 대시보드 Tera Ads의 MCP 서버입니다. Codex, Gemini CLI 등 MCP 클라이언트에 Meta 실시간 조회, Shopify 매출과 반품 후 이익, 한도가 있고 기록되는 광고 변경을 제공합니다. 무료 요금제는 Meta 광고 계정 하나에서 주 30회 호출을 포함하고, Connect Pro는 월 $15에 최대 광고 계정 세 개에서 월 3,000회 호출이며 Growth와 Scale 요금제에 포함됩니다. 다른 클라이언트의 설정 단계는 Connect 페이지에 있습니다.
자주 묻는 질문
Codex가 Meta 광고를 관리할 수 있나요?
네, MCP 서버를 통해서 가능합니다. codex mcp add tera-ads --url https://teraads.co/mcp 와 codex mcp login tera-ads 를 실행한 뒤 쉬운 말로 물어보세요. Codex가 무엇을 바꿀 수 있는지는 연결에 고른 모드에 따라 다릅니다.
Gemini CLI를 Facebook 광고에 연결하려면 어떻게 하나요?
gemini extensions install https://github.com/Teralabsx/meta-ads-mcp 를 실행한 뒤 Gemini CLI 안에서 /mcp auth tera-ads 를 실행하고 Tera Ads에 로그인하세요. 확장은 Meta 광고 계정의 Facebook과 Instagram 광고를 다룹니다.
Meta 개발자 앱이나 API 토큰이 필요한가요?
아니요. 브라우저에서 Tera Ads에 로그인하고, 변경은 Tera Ads의 승인된 Meta 앱을 통해 Meta에 전달됩니다. 설정 파일에 비밀 값은 들어가지 않습니다.
Codex 설정은 IDE 확장에서도 작동하나요?
네. OpenAI 문서에 따르면 ChatGPT 데스크톱 앱, Codex CLI, IDE 확장이 같은 MCP 설정을 공유하므로 CLI에서 추가한 서버가 나머지 둘에도 있습니다.
Gemini CLI는 아직 쓸 수 있나요?
Gemini CLI 문서에 따르면 무료 요금제와 Google One 사용자에게는 2026년 6월 18일에 Antigravity CLI로 대체되었습니다. 설정하기 전에 내 계정 유형에 대한 Google 문서를 확인하세요.
비용은 얼마인가요?
무료 요금제는 Meta 광고 계정 하나에서 주 30회 호출을 포함합니다. Connect Pro는 월 $15에 월 3,000회 호출입니다. 호출은 에이전트가 Tera Ads에서 하는 조회 한 번이며 질문 하나에 몇 번 필요할 수 있습니다.