AgentDomains MCP server

AgentDomains용 MCP 서버 — AI 에이전트가 만드는 웹사이트와 API를 위한 무료 도메인 서비스입니다. makes.fyi 또는 agentdomains.co 아래에서 DNS 레코드, HTTPS, URL 포워딩, 리버스 프록시 설정과 함께 MCP를 지원하는 모든 에이전트에게 실제 호스트명을 제공합니다.

실행 방법은 두 가지입니다. 로컬에서 npx를 통해 stdio로 실행하거나, 호스팅된 원격 엔드포인트 https://mcp.agentdomains.co를 이용하는 것입니다.

설치 (stdio)

설치 단계가 없습니다. npx가 온디맨드로 내려받습니다:

AGENTDOMAINS_API_KEY=adom_… npx -y @agentdomains/mcp

Related MCP server: domain-suite-mcp

Claude Code

claude mcp add agentdomains --env AGENTDOMAINS_API_KEY=adom_… -- npx -y @agentdomains/mcp

Claude Desktop 및 기타 설정 파일 클라이언트

claude_desktop_config.json(또는 사용 중인 클라이언트의 그에 해당하는 설정 파일)에 추가하세요:

{
  "mcpServers": {
    "agentdomains": {
      "command": "npx",
      "args": ["-y", "@agentdomains/mcp"],
      "env": { "AGENTDOMAINS_API_KEY": "adom_…" }
    }
  }
}

원격 엔드포인트

https://mcp.agentdomains.co

Streamable HTTP 방식입니다. Authorization 헤더에 API 키를 넣고 POST로 JSON-RPC를 보내세요:

curl -s https://mcp.agentdomains.co \
  -H 'Authorization: Bearer adom_…' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Claude Code에서는: claude mcp add --transport http agentdomains https://mcp.agentdomains.co --header "Authorization: Bearer adom_…"

설정

이미 Go 언어로 된 CLI를 사용한다면 그 ~/.agentdomains/config.json이 자동으로 인식되므로 환경 변수가 필요 없습니다.

아직 키가 없다면 signup 도구를 호출하세요. 자격 증명 없이도 키 하나를 바로 받을 수 있습니다. 키는 한 번만 표시되며 다시는 조회할 수 없습니다. 그러니 즉시 저장해 두세요. 계정은 임시 상태로 제공됩니다. attach_email로 이메일을 연결하고 30일 이내에 인증해야 합니다. 기간을 지키지 않으면 계정과 도메인이 삭제됩니다.

API 키는 로그에도 남지 않고, 출력에도 나오지 않으며, 어떤 도구 결과에도 포함되지 않습니다.

도구

모든 라벨 단위 도구는 선택적으로 domain 인자를 받을 수 있고(makes.fyi이 기본값, 다른 옵션은 agentdomains.co). 특정 DNS 레코드 하나만 삭제하는 엔드포인트는 없습니다.

HTTPS

"HTTPS로 만들어줘"는 여기서 한 가지 작업으로 해결되지 않습니다. 솔직한 두 가지 방법이 있습니다:

• set_proxy — 엣지에서 자체 인증서로 TLS를 종료하고 백엔드로 프록시합니다. 오리진에 아무것도 설치할 필요가 없습니다.

• add_acme_challenge — DNS-01 TXT 레코드를 게시하여 여러분의 ACME 클라이언트가 Let's Encrypt 증명서를 발급받을 수 있습니다(와일드카드이며, 공용 포트 80이 없는 호스트에 필요합니다). 일반적인 공개 웹 서버는 HTTP-01을 쓰면 충분하며 DNS 레코드 전혀 없습니다.

호환성

모든 MCP 클라이언트가 자동으로 지원됩니다. 일반적인 클라이언트에서 검증된 형식은 다음과 같습니다:

• Claude Code — 위에서 본 것처럼 claude mcp add (stdio 또는 --transport http) 를 사용합니다.

• Claude Desktop — claude_desktop_config.json의 mcpServers 블록.

• OpenAI Agents SDK — MCPServerStdio(params={"command": "npx", "args": ["-y", "@agentdomains/mcp"]}) 또는 원격 URL에 대한 MCPServerStreamableHttp.

• LangChain / LangGraph — langchain-mcp-adapters: MultiServerMCPClient({"agentdomains": {"command": "npx", "args": ["-y", "@agentdomains/mcp"], "transport": "stdio"}}).

• CrewAI — 동일한 stdio 인자를 사용하는 MCPServerAdapter.

• 그 밖의 무엇이든 — 클라이언트를 stdio의 npx -y @agentdomains/mcp나 Streamable HTTP의 https://mcp.agentdomains.co에 연결하세요.

개발

npm install
npm run build     # tsc -> dist/
npm run smoke     # boots dist/index.js, runs initialize + tools/list over stdio

Node 18+ 이 필요합니다. 유일한 런타임 의존성은 @modelcontextprotocol/sdk입니다.

관련 항목

• CLI (Go) — agentdomains 명령행 도구

• Agent 스킬 — Claude Code 플러그인

• 문서 · HTTP API

라이선스

FSL-1.1-Apache-2.0 — LICENSE를 참조하세요. CLI와 동일한 조건입니다.