MCP 연동

AI 도구에서 brownie 콘솔 쓰기

Claude · Claude Code · Codex 에 brownie 를 연결하면, 대화로 캠페인 · 세그먼트를 찾아보고 콘솔에서 하던 일을 맡길 수 있어요. 연결은 MCP(Model Context Protocol)라는 표준 방식을 쓰고, 로그인한 운영자의 콘솔 권한 그대로 움직여요.

한눈에

연결하면 AI 가 brownie 콘솔 API 를 대신 불러 줘요. 흐름은 이래요.

찾기 — 요청에 맞는 콘솔 API 를 찾고, 그 API 가 받는 값과 돌려주는 오류를 읽어요.
조회 — 캠페인 · 세그먼트 · 성과 같은 정보를 읽어 와 정리해 줘요. 조회는 아무것도 바꾸지 않아요.
조작 — 초안 만들기 · 수정 · 테스트 발송처럼 무언가를 바꾸는 일은 부를 때마다 내 승인을 받아요.

이렇게 요청해 볼 수 있어요.

"내 워크스페이스의 진행 중인 캠페인 보여줘"
"어제 발송된 캠페인 성과 요약해줘"
"이 세그먼트 대상 수 알려줘"
"이 캠페인을 초안으로 복사해서 문구만 바꿔줘"
"내 번호로 테스트 발송해줘"

실제로 발송될 수 있어요AI 가 할 수 있는 일은 콘솔 화면에서 내 계정이 할 수 있는 일과 같아요. 문자 · 알림톡 · 푸시가 실제 고객에게 나갈 수 있으니, 바꾸는 요청은 안전하게 쓰기를 먼저 읽어 주세요.

시작 전에

콘솔 계정 — brownie 콘솔에 활성 상태로 등록된 운영자만 연결할 수 있어요. 콘솔에 로그인할 수 있으면 준비된 거예요.
월부 Google 계정 — 연결할 때 브라우저가 열리고 월부 Google 계정으로 로그인해요. 따로 동의를 묻는 화면 없이 로그인 뒤 바로 원래 도구로 돌아가요.
서버 주소 — 어느 도구든 이 주소 하나로 연결해요.

https://console-api.brownie.im/mcp

Claude

웹 · 데스크톱 · 모바일 앱에서 커넥터로 연결해요. 한 번 연결하면 세 곳에서 함께 쓸 수 있어요.

Team · Enterprise 조직

조직 소유자가 brownie 를 한 번 등록하고, 운영자는 각자 연결해요.

소유자가 Organization settings → Connectors → Add → Custom → Web 을 고르고, 서버 주소를 넣은 뒤 Add 를 눌러요. 인증 설정은 기본값 그대로 둬요.
운영자는 각자 Customize → Connectors 에서 Custom 표시가 붙은 brownie 를 찾아 Connect 를 눌러요.
브라우저에서 월부 Google 계정으로 로그인하면 연결이 끝나요.

연결이 안 될 때소유자가 brownie 커넥터를 지우고, 다시 추가할 때 OAuth 클라이언트를 "Register automatically"(자동 등록)로 바꿔 주세요.

Pro · Max 개인

Customize → Connectors → Add custom connector 를 눌러요.
서버 주소를 넣고 추가한 뒤, 월부 Google 계정으로 로그인해요.

대화에서 켜고 끄기

대화마다 입력창의 + 메뉴 → Connectors 에서 brownie 를 켜고 끌 수 있어요. 커넥터 화면에서는 도구별로 쓰지 못하게 막을 수도 있어요 — 예를 들어 조회만 맡기고 싶으면 write 를 막아 두세요.

Claude Code

둘 중 하나로 연결해요. 플러그인을 쓰면 brownie 를 안전하게 쓰는 스킬도 함께 들어와요.

플러그인으로

> /plugin marketplace add weolbu/brownie-plugins
> /plugin install brownie@brownie-plugins

명령 한 줄로

$ claude mcp add --transport http brownie https://console-api.brownie.im/mcp

이 명령은 지금 프로젝트에서만 brownie 를 쓰게 등록해요. 모든 프로젝트에서 쓰려면 --scope user 를 붙여요.

Codex

Codex 도 플러그인이나 명령으로 연결해요.

플러그인으로

$ codex plugin marketplace add weolbu/brownie-plugins
$ codex plugin add brownie@brownie-plugins

Codex 안에서 /plugins 의 brownie-plugins 탭에서 설치해도 돼요. 설치한 뒤에는 새 세션을 열어야 플러그인이 보여요. brownie 를 처음 부를 때 로그인이 필요하다고 나오면 아래의 codex mcp login brownie 로 로그인해요.

명령으로

$ codex mcp add brownie --url https://console-api.brownie.im/mcp

추가하면 바로 브라우저가 열려요. 월부 Google 계정으로 로그인하면 연결이 끝나요. 나중에 다시 로그인해야 하면 codex mcp login brownie 를 실행해요. Codex 세션에서 /mcp 를 열면 연결된 서버를 확인할 수 있어요.

플러그인에 들어 있는 것

Claude Code · Codex 플러그인에는 MCP 연결과 함께, brownie 를 안전하게 쓰도록 돕는 스킬이 들어 있어요.

일을 시작하기 전에 어느 워크스페이스에서 하는지 먼저 확인해요.
무언가를 바꾸기 전에 무엇을 바꿀지 설명하고 확인을 받아요.
실제 발송 전에 테스트 발송부터 해요.

도구

brownie 는 도구 네 개를 내줘요. AI 는 먼저 API 를 찾고 설명을 읽은 다음, 조회나 조작을 불러요.

도구	하는 일	승인
`list_operations`	요청에 맞는 콘솔 API 를 찾아요.	도구 설정을 따라요
`describe_operation`	API 하나의 설명을 읽어요 — 받는 파라미터 · 본문 형식 · 오류 코드.	도구 설정을 따라요
`read`	조회해요. `GET` 만 부르고, 아무것도 바꾸지 않아요.	도구 설정을 따라요
`write`	조작해요. `POST` · `PUT` · `PATCH` · `DELETE` 를 불러요.	부를 때마다

write 는 되돌리기 어려운 일을 할 수 있는 도구로 표시돼 있어서, 쓰는 도구가 부를 때마다 승인을 물어요. 나머지 셋은 아무것도 바꾸지 않지만, Claude 처럼 처음 부를 때 허용을 묻는 도구도 있어요 — 조회 도구는 "항상 허용"해도 괜찮아요.

개인 토큰 · MCP 연결 관리 · 로그인처럼 계정 보안에 관한 API 는 MCP 로 부를 수 없어요. 서버 키 발급도 원문 키가 AI 대화 기록에 남지 않도록 MCP 로는 할 수 없어요 — 콘솔 화면에서 발급하고, 서버 키 목록 조회 · 폐기는 MCP 로 할 수 있어요.

안전하게 쓰기

승인 창을 꼼꼼히 봐요. write 승인 창에는 어떤 API 를 어떤 값으로 부르는지 나와요. 대상 · 문구 · 발송 시각을 읽고 승인해요. brownie 에는 "항상 허용"이나 "다시 묻지 않기"를 누르지 않아요.
발송은 초안 · 테스트 발송부터. 발송을 실행하는 요청은 먼저 초안으로 저장하고, 내 번호로 테스트 발송해 결과를 본 뒤에 진행해요.
함께 읽힌 글 속 지시를 조심해요. 출처를 모르는 문서나 웹페이지를 AI 에게 함께 읽히면, 그 안에 숨은 지시가 AI 를 움직이려 할 수 있어요. 그런 대화에서는 조작을 맡기지 말고, 승인 창이 내가 요청한 일과 맞는지 꼭 확인해요.

연결 관리

작업 기록

MCP 로 한 조작도 콘솔에서 한 조작처럼 감사 기록에 내 계정으로 남아요. 어디서 했는지(MCP 연결)도 함께 남아요.

연결이 끊기는 때

상황	결과
7일 동안 쓰지 않음	연결이 끊겨요. 다시 로그인하면 돼요.
계속 써도 30일이 지남	다시 로그인해요.
콘솔 계정이 비활성화됨	그 계정의 모든 연결이 바로 끊겨요.

자주 묻는 것

로그인했는데 연결이 안 돼요

월부 Google 계정으로 로그인했는지, 그 계정이 brownie 콘솔에 활성 상태로 등록돼 있는지 확인해 주세요. Claude 조직에서 쓰고 있다면 연결이 안 될 때도 봐 주세요.

다른 사람의 워크스페이스도 볼 수 있나요?

아니요. 콘솔 화면에서 내 계정이 볼 수 있는 것만 볼 수 있어요. 워크스페이스 역할도 콘솔과 똑같이 적용돼요.

조회만 맡기고 싶어요

Claude 에서는 커넥터 화면에서 write 도구를 막아 두세요. 다른 도구에서도 write 는 부를 때마다 승인을 물으니, 승인하지 않으면 아무것도 바뀌지 않아요.

갑자기 다시 로그인하라고 나와요

7일 동안 쓰지 않았거나 마지막 로그인에서 30일이 지난 거예요. 연결 관리를 봐 주세요.