Quidli Connect MCP

에이전트를 위한 신원(identity)과 평판(reputation) 기능입니다. 소셜 핸들을 지갑 주소로 조회하고, 평판을 확인하고, 토큰을 보낼 수 있습니다 — Cursor, Claude Desktop, Claude Code 또는 MCP 호환 클라이언트 어디서나.

한 줄 명령으로 사용해 보기

API 키가 필요 없습니다.

호스팅 — Claude Code에 추가:

claude mcp add --transport http quidli https://mcp.connect.quid.li/

로컬 — 내 컴퓨터에서 실행:

npx -y @quidli/connect-mcp

그다음 에이전트에게 요청해 보세요:

Farcaster 핸들 ahn.eth의 지갑 주소를 조회해 줘.

{
  "status": "completed",
  "results": [
    {
      "type": "farcaster",
      "value": "ahn.eth",
      "ethWalletAddress": "0x07De92Ce6474D718c80e696516bf0bE53290fF5E",
      "solWalletAddress": "9DD2CqPKZJoo7ZRgCXxJNMjhzfgVihSKtkZpn8qnEWK9"
    }
  ]
}

Telegram, Discord, Farcaster, X, GitHub, LinkedIn, 이메일, 전화번호까지 조회되며, Quidli를 사용한 적이 없는 사람을 위한 지갑도 생성합니다.

lookup, scores, agent, price는 키 없이 공유 익명 할당량(shared anonymous quota) 안에서 실행됩니다. 더 높은 한도와 본인 프로필(connect_me), Smart Send를 쓰려면 Connect API 키를 추가하세요.

Related MCP server: MCPAGENT

연결 방식 선택

connect.quid.li에서 Connect API 키를 받고 → API access 사용 설정을 켜면 더 높은 한도, connect_me, Smart Send를 쓸 수 있습니다.

호스팅(권장)

로컬 설정이 전혀 필요 없습니다. lookup, scores, agent, price는 API 키 없이(공유 익명 한도) 작동합니다. 키를 추가하면 더 높은 한도, 본인 프로필(connect_me), Smart Send를 사용할 수 있습니다.

Cursor

이미 다른 MCP 서버가 있다면: 딥링크를 건너뛰고 수동으로 추가하세요 — 일부 Cursor 버전에서는 원클릭 설치가 mcp.json 전체를 덮어쓸 수 있습니다.

Add to Cursor

또는 Cursor Settings → MCP → Add new MCP server에 붙여 넣으세요:

cursor://anysphere.cursor-deeplink/mcp/install?name=quidli-connect&config=eyJ1cmwiOiJodHRwczovL21jcC5jb25uZWN0LnF1aWQubGkifQ==

수동으로 추가 {#cursor-manual}

~/.cursor/mcp.json(전역) 또는 .cursor/mcp.json(프로젝트)의 mcpServers에 병합하세요 — 기존 항목을 대체하지 마세요:

"quidli-connect": {
  "url": "https://mcp.connect.quid.li"
}

선택 사항 — 더 높은 한도와 Smart Send:

"quidli-connect": {
  "url": "https://mcp.connect.quid.li",
  "headers": {
    "x-api-key": "<your-connect-api-key>"
  }
}

Claude Desktop

1. **Claude → 설정 → 커넥터(Connectors)**를 엽니다(이전 버전의 경우 설정 -> 설정 편집(Edit Config)).

2. URL https://mcp.connect.quid.li로 사용자 지정 MCP 커넥터를 추가한 다음, 선택적으로 헤더 x-api-key: <your-connect-api-key>를 설정하세요.

또는 설정 파일에 병합하고 Claude를 다시 시작하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "quidli-connect": {
      "url": "https://mcp.connect.quid.li"
    }
  }
}

Claude 버전이 원격 url 커넥터를 지원하지 않는다면 로컬 브리지를 대신 사용하세요(API는 여전히 호스팅되며 로컬에서 작은 도우미가 실행됩니다):

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "--http",
        "https://mcp.connect.quid.li"
      ]
    }
  }
}

브리지는 **Node.js 20+**가 필요합니다. 저장 후 Claude Desktop을 다시 시작하세요. 도구를 사용할 수 있으면 대화 입력창에 망치 아이콘이 표시됩니다.

키가 없어도 initialize/tools/list는 항상 성공합니다. 익명 트래픽인 tools/call은 전역 한도를 함께 사용하며, 초과 시 HTTP 429를 반환합니다 — 높은 한도로 필요하면 키를 받아야 합니다. 자리 표시자 키는 그래도 401을 반환합니다.

로컬(stdio)

지갑에 대해 호출당 결제를 원하거나 자격 증명을 로컬 env 파일에 두고 싶은 경우에 가장 적합합니다.

**Node.js 20+**가 필요합니다.

Cursor

다음 중 하나를 .cursor/mcp.json(프로젝트) 또는 전역 MCP 설정에 추가하세요.

옵션 A — API 키

호스팅 모드와 동일하지만 자격 증명이 내 컴퓨터에 남습니다.

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_KEY": "<your-connect-api-key>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li"
      }
    }
  }
}

옵션 B — x402 호출당 결제(지갑)

API 키 없음. 인증된 호출은 API가 HTTP 402를 반환하는 즉시 자동으로 결제됩니다. 지갑 개인 키는 로컬 프로세스만 파일 수 있습니다.

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x<wallet-with-usdc-on-base>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li",
        "CONNECT_X402_EVM_NETWORK": "8453"
      }
    }
  }
}

스테이징 API를 바라볼 때는 Base Sepolia에 84532를 사용하세요.

옵션 C — 자격 증명 없음(lookup / scores / agent)

MCP 프로세스는 CONNECT_API_KEY 또는 EVM_PRIVATE_KEY 없이 시작됩니다. connect_lookup, connect_scores_*, connect_agent_prompt, connect_get_price는 인증 없이 API를 호출합니다. 해당 호출은 x402 pay-per-call이 비활성화된 경우(기본적으로 로컬 환경에서 0) 성공합니다. x402가 활성화된 운영 환경에서는 키나 지갑을 설정할 때까지 해당 도구들이 HTTP 402를 반환합니다.

connect_me, c_connect_conn_drop, connect_drop_balance는 여전히 CONNECT_API_KEY가 필요합니다.

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_BASE_URL": "http://127.0.0.1:3011"
      }
    }
  }
}

Claude Desktop

1. **Claude → 설정 → 개발자 → 구성 파일 편집(Edit Config)**을 엽니다. 나타나지 않는 경우 개발자 모드를 먼저 활성화하세요.

2. 아래 블록 중 하나를 mcpServers에 병합합니다:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Claude Desktop을 다시 시작하세요.

옵션 A — API 키

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "CONNECT_API_KEY": "<your-connect-api-key>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li"
      }
    }
  }
}

옵션 B — x402 호출당 결제(지갑)

{
  "mcpServers": {
    "quidli-connect": {
      "command": "npx",
      "args": ["-y", "@quidli/connect-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x<wallet-with-usdc-on-base>",
        "CONNECT_API_BASE_URL": "https://api.connect.quid.li",
        "CONNECT_X402_EVM_NETWORK": "8453"
      }
    }
  }
}

CONNECT_API_KEY와 EVM_PRIVATE_KEY가 모두 설정된 경우에는 API 키가 사용됩니다.

로컬 모드에서는 자격 증명이 선택 사항입니다. 두 변수가 모두 없어도 API가 x402 요금을 청구하지 않는 한 lookup/scores/ag agent는 계속 작동합니다. connect_target 및 Smart Send 도구에는 CONNECT_API_KEY가 필요합니다.

도구

Connect 데이터나 작업이 필요할 때 클라이언트가 이 도구들을 사용하도록 요청하세요.