본문으로 건너뛰기

Logto MCP Server

Logto MCP Server는 원격 MCP (Model Context Protocol) 서버입니다. AI 애플리케이션에 URL을 추가하고, Logto Cloud 계정으로 로그인한 후, Logto와 대화를 시작하세요.

팁:

Logto MCP Server는 Logto와 MCP Auth로 구축되었습니다. 직접 원격 MCP 서버를 구축하고 싶다면 직접 원격 MCP 서버 구축하기를 참고하세요.

할 수 있는 일​

  • 프로젝트에 인증 (Authentication) 추가하기: AI가 프레임워크를 감지하고, Logto 애플리케이션을 생성하며, 동작하는 통합 코드를 생성합니다. React, Next.js, Vue, Nuxt, SvelteKit, Express, Go, Python, iOS, Android, Flutter 등 38개 이상의 프레임워크를 지원합니다.
  • Logto에 대해 질문하기: AI가 Logto 문서를 검색하여 출처와 함께 답변을 제공합니다.

곧 로그인 경험 설정, 역할 기반 접근 제어 (RBAC) 및 권한 관리, 조직을 활용한 B2B 앱 구축을 위한 다중 테넌시 설정 등 더 많은 기능이 추가될 예정입니다.

AI 애플리케이션 연결 방식​

Logto MCP Server는 AI 애플리케이션이 로그인 시 자신을 식별할 수 있는 두 가지 방법을 지원합니다. 두 방법 모두 Logto Cloud에서 별도의 설정이 필요하지 않습니다.

  • 서버 URL만 사용 (권장): 대부분의 AI 애플리케이션은 이제 클라이언트 ID 메타데이터 문서 (CIMD)를 지원합니다. 애플리케이션은 자신이 소유한 URL을 클라이언트 ID로 사용하고, Logto는 해당 URL에서 애플리케이션 이름과 리디렉션 URI를 읽어옵니다. 서버 URL https://mcp.logto.io만 입력하면 됩니다.
  • 고정 클라이언트 ID: 아직 CIMD를 지원하지 않는 애플리케이션의 경우, 공개 OAuth 클라이언트 ID mcp-client를 입력하세요. 이 클라이언트는 루프백 리디렉션 URI (http://localhost 또는 http://127.0.0.1의 임의 포트)를 허용합니다.

두 옵션이 모두 있다면 서버 URL만 사용하세요. 기존에 mcp-client를 사용해 연결된 경우에도 계속 동작하므로 재연결할 필요가 없습니다.

서버 URL만으로 연결하면, Logto Cloud 로그인 페이지에 애플리케이션 이름과 클라이언트 ID URL의 호스트(예: claude.ai 또는 vscode.dev)가 표시된 동의 화면이 나타납니다. 인가 전에 호스트가 사용 중인 애플리케이션과 일치하는지 확인하세요.

AI 애플리케이션에서 설정하기​

Amp​

  1. Amp에서 Personal Settings > Integrations & MCP로 이동하여 Add MCP Server를 클릭하세요.
  2. 이름에 Logto MCP Server를 입력하고 서버 URL로 https://mcp.logto.io를 입력하세요. Amp가 인증 방식을 자동으로 감지합니다.
  3. Connect를 클릭하고 Amp의 안내에 따라 로그인하세요.
  4. Logto Cloud 계정으로 로그인하고 연결을 인가하세요.
팁:

Amp가 Detecting Authentication 단계에서 오래 머무를 경우, Change를 클릭하고 OAuth를 선택하여 자동 인증 감지를 건너뛰세요. Use Your Own OAuth App의 OAuth Client ID와 OAuth Client Secret은 비워두고, Connect를 클릭한 후 로그인 안내를 따르세요. Amp는 CIMD를 지원하므로 OAuth 앱 등록이나 mcp-client 입력이 필요하지 않습니다.

Claude Code​

claude mcp add --transport http logto https://mcp.logto.io

이후, Claude Code에서 /mcp를 실행하고 logto를 선택한 뒤, 브라우저 로그인 플로우를 따라 Logto Cloud 계정으로 인증하세요. 또는 쉘에서 claude mcp login logto를 실행할 수도 있습니다.

Claude (웹 및 데스크톱)​

  1. Customize > Connectors로 이동하여 Add custom connector를 클릭하세요.
  2. 이름에 Logto MCP Server와 원격 MCP 서버 URL https://mcp.logto.io를 입력하세요. Advanced settings의 OAuth 설정은 비워두고 Add를 클릭하세요.
  3. Connectors 목록에서 Logto MCP Server를 찾아 Connect를 클릭하세요.
  4. Logto Cloud 로그인 페이지로 리디렉션됩니다. Logto Cloud 계정으로 로그인하고 연결을 인가하세요.

커넥터는 Claude 계정에 저장되므로 웹과 Claude Desktop 모두에서 사용할 수 있습니다.

Codex​

codex mcp add logto --url https://mcp.logto.io
codex mcp login logto

브라우저 창이 열립니다. Logto Cloud 계정으로 로그인하여 연결하세요. ChatGPT 데스크톱 앱, Codex CLI, Codex IDE 확장 프로그램이 이 구성을 공유합니다.

Cursor​

Cursor는 아직 CIMD를 지원하지 않으므로 고정 클라이언트 ID를 사용합니다.

  1. Customize > MCPs로 이동하거나, ~/.cursor/mcp.json(글로벌) 또는 .cursor/mcp.json(프로젝트)을 엽니다.

  2. 다음 구성을 추가하세요:

    {
      "mcpServers": {
        "Logto": {
          "url": "https://mcp.logto.io",
          "auth": {
            "CLIENT_ID": "mcp-client",
            "scopes": ["mcp:all"]
          }
        }
      }
    }

  3. 서버 옆의 Connect를 클릭하세요. Logto Cloud 로그인 페이지가 나타납니다. Logto Cloud 계정으로 로그인하여 연결하세요.

Cursor 데스크톱 앱에서 로그인하세요. 웹 및 Cursor Agents에서 사용하는 웹 콜백은 지원되지 않습니다.

OpenCode​

  1. opencode.json 파일에 다음 구성을 추가하세요:

    {
      "$schema": "https://opencode.ai/config.json",
      "mcp": {
        "Logto": {
          "enabled": true,
          "type": "remote",
          "url": "https://mcp.logto.io"
        }
      }
    }

  2. 다음 명령어로 인증을 진행하세요:

    opencode mcp auth Logto

    여기서 Logto는 구성 파일의 MCP 서버 이름과 일치해야 합니다.

브라우저 창이 열립니다. Logto Cloud 계정으로 로그인하여 인가 및 연결하세요.

VS Code​

  1. 명령 팔레트(Command + Shift + P)를 열고 **MCP: Add Server...**를 선택하세요.
  2. 서버 유형으로 HTTP를 선택하세요.
  3. URL에 https://mcp.logto.io를 입력하세요. 워크스페이스에 설치하여 더 나은 격리 및 관리를 할 수 있습니다.
  4. VS Code에서 인증을 요청하면 허용하세요. Logto Cloud 로그인 페이지로 리디렉션됩니다. Logto Cloud 계정으로 로그인하여 연결하세요.

또는 .vscode/mcp.json 또는 사용자 mcp.json에 서버를 추가할 수 있습니다:

{
  "servers": {
    "logto": {
      "type": "http",
      "url": "https://mcp.logto.io"
    }
  }
}

Windsurf​

Windsurf는 CIMD 지원을 문서화하지 않았으므로, 고정 클라이언트 ID와 함께 mcp-remote를 사용하세요.

  1. 명령 팔레트(Command + Shift + P)를 열고 Windsurf: MCP Marketplace를 선택하세요.

  2. Installed MCPs 섹션에서 오른쪽의 설정 아이콘을 클릭하여 MCP 구성 파일을 엽니다.

  3. 다음 구성을 추가하세요:

    {
      "mcpServers": {
        "Logto": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://mcp.logto.io",
            "--allow-http",
            "--static-oauth-client-info",
            "{ \"client_id\": \"mcp-client\", \"scope\": \"mcp:all\" }",
            "--resource",
            "https://mcp.logto.io/"
          ]
        }
      }
    }

Logto Cloud 로그인 페이지가 자동으로 나타납니다. Logto Cloud 계정으로 로그인하여 연결하세요.

기타 MCP 클라이언트​

Logto MCP Server는 OAuth 인가를 지원하는 모든 MCP 클라이언트와 호환됩니다:

  • 클라이언트가 CIMD를 지원하는 경우: MCP 서버 URL https://mcp.logto.io만 입력하세요. 클라이언트가 나머지 정보를 서버에서 자동으로 가져옵니다.
  • 그 외의 경우: 다음 구성을 사용하세요.
    • MCP 서버 URL: https://mcp.logto.io
    • OAuth 클라이언트 ID: mcp-client (클라이언트 시크릿 없음)
    • 리디렉션 URI: http://localhost:<port>/callback과 같은 루프백 주소
    • 리소스: https://mcp.logto.io/ (클라이언트가 필요로 할 경우)
    • 스코프: mcp:all (클라이언트가 필요로 할 경우)

Logto MCP Server는 Dynamic Client Registration (DCR)을 지원하지 않습니다. AI 애플리케이션 개발자라면, 애플리케이션을 위해 클라이언트 ID 메타데이터 문서 게시를 진행하면 Logto에서 별도 설정 없이 연결할 수 있습니다. 불가능하다면, 문의하기로 애플리케이션 정보를 보내주세요.

직접 원격 MCP 서버 구축하기​

Logto MCP Server는 Logto와 MCP Auth로 구축되었습니다. 인증 기능이 포함된 원격 MCP 서버를 직접 구축하고 싶다면 다음 리소스를 참고하세요: