Claude, ChatGPT, Cursor와 같은 AI 어시스턴트를 사용하여 최대 100개의 디렉토리에 클라이언트 제품을 출시합니다.
다른 이름 submitator/submitator-mcp, submitator-mcp
- 스타
- 0
- Tools
- 4
- 다운로드, 30일
- —
- 최신 버전
- 0.1.4
- 마지막 커밋
- 2026년 11월 15일
- 라이선스
- MIT
Submitator MCP란?
Submitator은(는) MCP server입니다. Claude, ChatGPT, Cursor와 같은 AI 어시스턴트를 사용하여 최대 100개의 디렉토리에 클라이언트 제품을 출시합니다. 4개 도구를 제공합니다. 예: whoami, preview_launch, launch_project.
프로젝트 README에서 생성된 요약
Submitator MCP server 정보
여러 클라이언트 제품을 관리하는 에이전시는 Claude, ChatGPT, Cursor와 같은 AI 어시스턴트를 사용하여 최대 100개의 디렉토리에 제품을 출시할 수 있습니다. 이 MCP server는 에이전시 키를 사용하여 어시스턴트를 Submitator API에 연결하며, 채팅 인터페이스에서 클라이언트 프로젝트를 직접 관리할 수 있게 합니다. URL을 통해 프로젝트를 생성하고, 스크린샷을 관리하며, 리스팅이 라이브되는 과정을 추적할 수 있습니다.
사용자는 로컬 이미지 업로드 및 PDF 또는 XLSX 보고서 저장 등 모든 기능을 사용하기 위해 npx를 통해 로컬에서 실행할 수 있습니다. 또는 Claude.ai 및 ChatGPT와 같은 웹 기반 클라이언트를 위해 OAuth 인증을 사용하는 원격 서버를 이용할 수 있습니다. 시스템은 무료 실험을 위한 테스트 키와 실제 제출을 위한 라이브 키를 모두 지원합니다.
preview_launch와 같은 특정 도구를 사용하면 실제 실행 전 디렉토리 수와 비용을 확인하는 드라이 런을 수행할 수 있습니다. 또한 클라이언트 진행 보고서를 생성하고 브랜드 배지를 관리하는 도구도 제공합니다. 보안을 위해 서버는 크레딧을 사용하는 launch_project와 같은 작업을 수행하기 전, 어시스턴트가 반드시 확인을 요청하도록 destructive hint를 사용합니다.
활용 사례
- 1제품 디렉토리 출시 자동화단일 명령어를 통해 클라이언트 프로젝트를 여러 디렉토리에 제출하는 프로세스를 시작합니다.
- 2출시 전 비용 및 도달 범위 추정드라이 런을 수행하여 도달 가능한 디렉토리 수와 총 비용을 확인합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Submitator MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Submitator MCP 설치
$ claude mcp add --env 'SUBMITATOR_API_KEY=<YOUR_SUBMITATOR_API_KEY>' submitator-mcp -- npx -y submitator-mcpCursor에 Submitator MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"submitator-mcp": {
"command": "npx",
"args": [
"-y",
"submitator-mcp"
],
"env": {
"SUBMITATOR_API_KEY": "<YOUR_SUBMITATOR_API_KEY>"
}
}
}
}VS Code에 Submitator MCP 설치
.vscode/mcp.json
{
"servers": {
"submitator-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"submitator-mcp"
],
"env": {
"SUBMITATOR_API_KEY": "<YOUR_SUBMITATOR_API_KEY>"
}
}
}
}VS Code CLI에 Submitator MCP 설치
$ code --add-mcp '{"name":"submitator-mcp","type":"stdio","command":"npx","args":["-y","submitator-mcp"],"env":{"SUBMITATOR_API_KEY":"<YOUR_SUBMITATOR_API_KEY>"}}'Claude Desktop에 Submitator MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"submitator-mcp": {
"command": "npx",
"args": [
"-y",
"submitator-mcp"
],
"env": {
"SUBMITATOR_API_KEY": "<YOUR_SUBMITATOR_API_KEY>"
}
}
}
}Codex에 Submitator MCP 설치
$ codex mcp add submitator-mcp --env 'SUBMITATOR_API_KEY=<YOUR_SUBMITATOR_API_KEY>' -- npx -y submitator-mcpCodex config.toml에 Submitator MCP 설치
~/.codex/config.toml
[mcp_servers.submitator-mcp] command = "npx" args = ["-y", "submitator-mcp"] [mcp_servers.submitator-mcp.env] SUBMITATOR_API_KEY = "<YOUR_SUBMITATOR_API_KEY>"
Gemini CLI에 Submitator MCP 설치
$ gemini mcp add -s user -e 'SUBMITATOR_API_KEY=<YOUR_SUBMITATOR_API_KEY>' submitator-mcp npx -- -y submitator-mcpGemini settings.json에 Submitator MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"submitator-mcp": {
"command": "npx",
"args": [
"-y",
"submitator-mcp"
],
"env": {
"SUBMITATOR_API_KEY": "<YOUR_SUBMITATOR_API_KEY>"
}
}
}
}Submitator MCP 도구 4
README에서 감지됨whoamipreview_launchlaunch_projectadd_directories
| whoami | — | |
| preview_launch | — | |
| launch_project | — | |
| add_directories | — |
구성
SUBMITATOR_API_KEY필수비밀Agency API key from the Submitator agency console (sbm_live_ or sbm_test_)
SUBMITATOR_FILES_DIR
| 이름 | 설명 | 유형 |
|---|---|---|
| SUBMITATOR_API_KEY | Agency API key from the Submitator agency console (sbm_live_ or sbm_test_) | 필수비밀 |
| SUBMITATOR_FILES_DIR | — |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기Submitator MCP server
Launch your clients' products on up to 100 directories each from Claude, ChatGPT, Cursor or VS Code.
This MCP server is for agencies on Submitator's white label plan. Your assistant creates a client project from a URL, shows which directories it would reach, launches it once you agree, and follows the listings as they go live. The badge, the report and the client page carry your agency's brand. It calls the Submitator API with your agency key and does nothing the API does not.
What you need
- An agency account: app.submitator.com/agency/start.
- An API key from Developers in the agency console. With claude.ai or ChatGPT, the sign-in creates
one (see Remote server).
- A
sbm_test_key is free from the day you create the agency. It runs in test mode: projects and listings are test data, nothing is submitted, and its test launches are not bought ones. - A
sbm_live_key comes with your first purchase. Eachlaunch_projectspends one launch.
- A
Install
The package runs on your machine with npx (Node.js 20 or newer). Keep the key in your user-level
config, never in a file that lives in a repository.
Claude Code (user scope, so the key stays out of the project's .mcp.json)
claude mcp add --scope user submitator --env SUBMITATOR_API_KEY=sbm_test_... -- npx -y submitator-mcp
Cursor (~/.cursor/mcp.json, the user-level file)
{
"mcpServers": {
"submitator": {
"command": "npx",
"args": ["-y", "submitator-mcp"],
"env": { "SUBMITATOR_API_KEY": "sbm_test_..." }
}
}
}
VS Code (.vscode/mcp.json): VS Code asks for the key and keeps it out of the file.
{
"inputs": [
{ "type": "promptString", "id": "submitator-key", "description": "Submitator API key", "password": true }
],
"servers": {
"submitator": {
"type": "stdio",
"command": "npx",
"args": ["-y", "submitator-mcp"],
"env": { "SUBMITATOR_API_KEY": "${input:submitator-key}" }
}
}
}
Claude Desktop (claude_desktop_config.json): the same block as Cursor, under mcpServers. Claude
Desktop starts servers in the disk root, so add "SUBMITATOR_FILES_DIR": "/path/to/client/images" to env
if you want to upload local images.
Devin Desktop (formerly Windsurf), Cline and other MCP clients: run npx -y submitator-mcp with
SUBMITATOR_API_KEY in its environment, or use the remote server below.
Remote server
The remote server at https://mcp.submitator.com/mcp needs no install. There are two ways in:
claude.ai and ChatGPT sign in to Submitator, and other clients send an agency key in a header.
claude.ai: sign in
- In claude.ai, open Customize > Connectors, press + Add, then Add custom connector.
- Enter the name
Submitatorand the URLhttps://mcp.submitator.com/mcp, then press Continue. Check the settings it found and press Continue again. - Under Authentication pick Sign in now, keep Use Claude's published identity (Recommended) as the OAuth client, leave Request headers empty and press Add.
- Submitator's sign-in opens: log in to the agency console. The consent page names the client and its host (Claude, claude.ai). Pick Test or Live and Full or Read only, then press Allow Claude.
- In a chat, open +, then Connectors, and switch Submitator on.
This link opens the dialog of step 1 with the name and the URL filled in.
The sign-in creates a key labelled MCP: Claude on the console's Developers page. Revoke it there
to disconnect: the next call asks to sign in again. Live needs an agency that has bought launches, so a
new agency gets Test only, and test mode submits nothing.
On Team and Enterprise plans an Owner adds the connector first, under Organization settings > Connectors: Add, Custom, Web. Members then press Connect under Customize > Connectors, and each of them signs in.
ChatGPT: sign in
- In ChatGPT on the web, open Plugins (chatgpt.com/plugins), press the plus button, then Add custom MCP server.
- Enter the name
Submitatorand, under Connection, the Server URLhttps://mcp.submitator.com/mcp. - For authentication pick OAuth with a Client ID Metadata Document (CIMD), and enter no client ID or secret: Submitator's sign-in reads ChatGPT's published client document and needs no client registration.
- Review the risk warning, select I understand and want to continue, then Create as a plugin.
- Install the plugin, then in a chat type
@and pick it.
When ChatGPT sends you to Submitator's sign-in, log in to the agency console, pick Test or Live
and Full or Read only on the consent page, and allow ChatGPT. As with claude.ai, the sign-in
creates a key whose label starts with MCP: on the console's Developers page (revoke it there to
disconnect), and a new agency gets Test only.
OpenAI's documentation says ChatGPT
asks for confirmation before write actions by default and treats a tool without readOnlyHint as a
write. Here the tools that only read carry readOnlyHint: true, and every other tool false. In a
workspace, its permissions and security settings apply to adding and using custom MCP servers.
Claude Code, Cursor, VS Code and other clients: a key in a header
URL: https://mcp.submitator.com/mcp
Header: Authorization: Bearer <your key> (X-API-Key: <your key> works too)
Claude Code
claude mcp add --transport http submitator https://mcp.submitator.com/mcp \
--header "Authorization: Bearer $SUBMITATOR_API_KEY"
Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"submitator": {
"url": "https://mcp.submitator.com/mcp",
"headers": { "Authorization": "Bearer sbm_test_..." }
}
}
}
VS Code (.vscode/mcp.json): VS Code asks for the key and keeps it out of the file.
{
"inputs": [
{ "type": "promptString", "id": "submitator-key", "description": "Submitator API key", "password": true }
],
"servers": {
"submitator": {
"type": "http",
"url": "https://mcp.submitator.com/mcp",
"headers": { "Authorization": "Bearer ${input:submitator-key}" }
}
}
}
Other clients that connect over HTTP take the same URL and header.
The remote server keeps nothing between requests: it passes the key, from the header or from the
sign-in's access token, on to the Submitator API and forgets it. Files cannot be read or saved there,
so save_report_file and local image paths work only with the npx package.
Tools
| Tool | What it does |
|---|---|
whoami |
The agency and mode behind the key, its permissions, launches left and the hourly budget |
list_projects, get_project |
Find client projects; read one in full |
create_project, update_project, delete_draft |
Create a project from a URL, change its fields, delete a draft |
set_logo, add_screenshot, remove_image |
Images from a public URL, or a local file with the npx package |
preview_launch |
Free dry run of a launch or an add with the same arguments: how many directories, what is missing, the cost, plus the top and median DR of the auto pick |
find_directories, project_directories |
Search the catalog; see one project's directory choices |
launch_project |
Start submissions. Spends one launch; refuses unless confirm_selected equals the count preview_launch shows for the same arguments |
add_directories |
Reach more directories from a launched project's free allowance, with the same check |
list_listings, list_events |
Follow listings and what changed since a given time |
get_badge, verify_badge |
The badge install code for the client's site, and a check that it is there |
create_report, get_report, save_report_file |
Build a PDF or XLSX report; save it to disk with the npx package |
get_share_link, create_share_link, delete_share_link |
The client's progress page (live keys) |
advance_test_listing, set_test_launches |
Test mode helpers (test keys) |
Prompts: launch_client_project walks through a launch, and client_progress_update drafts a note for
your client that does not name Submitator.
Keys and safety
- Keep your client's approval prompt on for
launch_project,add_directoriesandupdate_projectinstead of allowing them always: a launch spends money. These three, like every tool that overwrites or deletes data or submits to directories, carrydestructiveHint: true, so clients that read the hint ask before each call. Tools that only add or check, such ascreate_project,add_screenshotandverify_badge, carryfalse. With a live key, clients that support questions to their user (MCP elicitation) also ask you before a launch or an add, and the answer never passes through the model. The remote server keeps no session, so there this question reaches only clients on MCP protocol 2026-07-28. - The
npxpackage reads the key from its environment and sends it only tohttps://api.submitator.com. - Local images are read only from
SUBMITATOR_FILES_DIR(or the folder the client starts the server in), only real PNG, JPEG, GIF or WebP files, and never through a link. Reports are saved to Downloads by default and never over an existing file; reports that include logins are not saved here. - A read-only key fits an assistant that only checks status: projects, listings, events and existing reports. Building a report or a client page link needs a key with full permissions.
- Logins and their passwords are not exposed through this server. Read them in the agency console.
- Every call shows up in Developers, Request log with a request id that starts with
mcp-. Revoke a key there at any time. - Report a vulnerability by email to vlad@submitator.com, not in a public issue (SECURITY.md).
Development
npm install
npm test # unit, contract and protocol tests
npm run build
npm run sync:openapi # refresh openapi/v1.json and src/v1.d.ts from the public contract
npm run check:pack # pack, install in an empty folder, run the stdio handshake
When the API ships a new release, npm run sync:openapi and npm test show which new operations need
a tool or a line in EXCLUDED (src/tools/index.ts).
License
MIT
Submitator MCP 질문
Submitator MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'SUBMITATOR_API_KEY=<YOUR_SUBMITATOR_API_KEY>' submitator-mcp -- npx -y submitator-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Submitator MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Submitator MCP는 어떤 도구를 제공하나요?
4개 도구를 제공합니다. 예: whoami, preview_launch, launch_project, add_directories.
sbm_test 키와 sbm_live 키의 차이점은 무엇인가요?
sbm_test_ 키는 무료이며, 프로젝트와 리스팅이 실제 제출 없이 테스트 데이터를 사용하는 테스트 모드로 실행됩니다. sbm_live_ 키는 실제 출시 시 사용하며 첫 구매 시 발급됩니다.
프로젝트에 로컬 이미지를 업로드할 수 있나요?
네, 하지만 로컬 파일 경로를 처리하려면 원격 서버 대신 npx 패키지를 사용해야 합니다.
출시 과정에서 의도치 않은 비용 지출을 방지하려면 어떻게 해야 하나요?
launch_project와 같이 비용이 발생하는 도구에 대해 클라이언트 승인 프롬프트를 활성화할 수 있습니다. 이는 실행 전 확인을 거치도록 destructive hint를 포함합니다.