Gripp MCP

https://api.gripp.com/public/api3.php의 Gripp API 3.0 엔드포인트용 Model Context Protocol 서버입니다.

Gripp API는 JSON-RPC와 유사합니다. 요청은 배치 배열로 POST되며, API 토큰은 Authorization: Bearer <token>으로 전송됩니다.

설정

npm install
npm run fetch:metadata
npm run build

서버를 시작하기 전에 Gripp API 토큰을 설정하세요:

export GRIPP_API_TOKEN="your-token"
npm start

선택적 환경 변수:

GRIPP_API_URL=https://api.gripp.com/public/api3.php
GRIPP_REQUEST_TIMEOUT_MS=30000

GRIPP_API_URL은 의도적으로 https://api.gripp.com/ 호스트로 제한됩니다.

Related MCP server: SuperOps MCP Server

MCP 클라이언트 구성

stdio 구성 예시:

{
  "mcpServers": {
    "gripp": {
      "command": "node",
      "args": ["/absolute/path/to/MCP Gripp/dist/src/cli.js"],
      "env": {
        "GRIPP_API_TOKEN": "your-token"
      }
    }
  }
}

패키지를 게시하거나 연결한 후에는 gripp-mcp 바이너리도 실행할 수 있습니다.

Vercel 원격 MCP

이 저장소는 Next.js 라우트를 통해 Vercel용 Streamable HTTP MCP 엔드포인트도 제공합니다:

https://your-vercel-domain.vercel.app/api/mcp

Claude 사용자 지정 커넥터에는 /api/mcp URL을 사용하세요. 루트 URL은 상태 응답만 반환합니다.

Gripp 도구를 사용하기 전에 Vercel에서 이 환경 변수를 설정하세요:

GRIPP_API_TOKEN=your-token
MCP_ACCESS_KEY=long-random-secret

Claude의 사용자 지정 커넥터 URL에 액세스 키를 사용하세요:

https://your-vercel-domain.vercel.app/api/mcp?access_key=long-random-secret

/api/mcp 엔드포인트는 프로덕션에서 MCP_ACCESS_KEY가 설정되지 않으면 폐쇄 실패(fail closed)합니다. URL이 유출되면 Vercel에서 MCP_ACCESS_KEY를 교체하고 재배포하세요.

원격 엔드포인트는 Authorization: Bearer <token> 또는 x-gripp-api-token에서 Gripp 토큰을 읽을 수도 있지만, Claude의 사용자 지정 커넥터 UI는 현재 간단한 사용자 지정 헤더 필드를 제공하지 않습니다. Claude의 경우 실용적인 설정은 Vercel 프로젝트 환경에 GRIPP_API_TOKEN을 저장하는 것입니다.

GoHighLevel 원격 MCP

동일한 Vercel 프로젝트는 OAuth 토큰 저장소와 함께 GoHighLevel MCP 엔드포인트도 호스팅할 수 있습니다:

https://your-vercel-domain.vercel.app/api/connect/mcp

Vercel에서 다음 환경 변수를 설정하세요:

GHL_CLIENT_ID=your-highlevel-client-id
GHL_CLIENT_SECRET=your-highlevel-client-secret
GHL_APP_ID=your-highlevel-app-or-version-id
GHL_INSTALL_URL=your-highlevel-installation-url
GHL_REDIRECT_URI=https://your-vercel-domain.vercel.app/api/connect/callback
GHL_OAUTH_USER_TYPE=Company
GHL_MCP_ACCESS_KEY=long-random-secret
GHL_TOKEN_ENCRYPTION_KEY=$(openssl rand -hex 32)
KV_REST_API_URL=your-upstash-or-vercel-kv-rest-url
KV_REST_API_TOKEN=your-upstash-or-vercel-kv-rest-token

KV_* 이름 대신 UPSTASH_REDIS_REST_URL 및 UPSTASH_REDIS_REST_TOKEN도 작동합니다.

HighLevel Marketplace 앱 설정에서 이 리디렉션 URL을 추가하세요:

https://your-vercel-domain.vercel.app/api/connect/callback

그런 다음 브라우저에서 OAuth 시작 URL을 엽니다:

https://your-vercel-domain.vercel.app/api/connect/start

HighLevel이 다시 리디렉션하면 콜백 페이지가 해당 하위 계정 설치를 저장합니다. Claude의 사용자 지정 커넥터 화면에서 하나의 공유 URL을 사용하세요:

https://your-vercel-domain.vercel.app/api/connect/mcp?access_key=long-random-secret

/api/connect/start를 다시 열고 다음 위치를 선택하여 하위 계정별로 앱을 한 번 설치하세요. MCP는 연결된 모든 설치의 인덱스를 유지합니다. Claude에서 먼저 ghl_list_installations를 호출한 다음 선택한 installId를 연락처, 기회 또는 일반 API 도구에 전달하세요.

Marketplace 앱을 에이전시 관리자만 설치할 수 있는 경우 GHL_OAUTH_USER_TYPE=Company로 설정하세요. 에이전시 수준에서 한 번 설치한 후 ghl_list_installed_locations를 사용하여 앱이 실제로 설치된 위치를 확인한 다음 ghl_connect_location으로 쿼리하려는 하위 계정에 대한 저장된 Location 설치를 생성하세요. ghl_list_locations는 표시되는 하위 계정만 나열하며 앱이 설치되었음을 증명하지 않습니다.

GoHighLevel MCP는 프로덕션에서 GHL_MCP_ACCESS_KEY, 암호화된 토큰 저장소 또는 OAuth 자격 증명이 없으면 폐쇄 실패(fail closed)합니다.

GoHighLevel 도구

• ghl_installation_status: 토큰을 노출하지 않고 OAuth 설치 메타데이터를 표시합니다.

• ghl_list_installations: 연결된 모든 하위 계정/설치를 나열합니다.

• ghl_list_locations: 연결된 에이전시/회사 설치에서 하위 계정을 나열/검색합니다.

• ghl_list_installed_locations: 이 앱이 설치/승인된 위치를 나열합니다.

• ghl_connect_location: 에이전시/회사 설치에서 Location 토큰을 생성하고 저장합니다.

• ghl_get_contact: 연락처 ID로 연락처 하나를 검색합니다.

• ghl_search_contacts: /contacts/search로 연락처를 검색합니다.

• ghl_create_contact: 연락처를 생성합니다. confirm: true가 필요합니다.

• ghl_update_contact: 연락처를 업데이트합니다. confirm: true가 필요합니다.

• ghl_search_opportunities: /opportunities/search로 기회를 검색합니다.

• ghl_api_call: 모든 상대 HighLevel API 경로를 호출합니다. GET이 아닌 호출에는 confirm: true가 필요합니다.

Claude용 공유 Google Ads MCP

여러 사람이 Claude에서 사용할 수 있는 공유 Google Ads MCP의 경우, 로컬 stdio MCP 프로세스 대신 공식 googleads/google-ads-mcp 서버를 별도의 원격 서비스로 실행하세요.

Cloud Run 배포 및 Claude 사용자 지정 커넥터 설정은 docs/google-ads-mcp-claude.md를 참조하세요.

도구

• gripp_list_entities: 사용 가능한 Gripp 엔티티 및 메서드 이름을 나열합니다.

• gripp_describe_entity: 하나의 엔티티에 대한 필드, 열거형 값, 참조, 메서드 및 예제를 검사합니다.

• gripp_get: 필터 및 옵션으로 <entity>.get을 호출합니다.

• gripp_getone: 필터로 <entity>.getone을 호출합니다.

• gripp_create: <entity>.create를 호출합니다. confirm: true가 필요합니다.

• gripp_update: <entity>.update를 호출합니다. confirm: true가 필요합니다.

• gripp_delete: <entity>.delete를 호출합니다. confirm: true가 필요합니다.

• gripp_call: 전체 이름으로 문서화된 모든 Gripp 메서드를 호출합니다.

• gripp_batch: 하나의 트랜잭션에서 여러 문서화된 Gripp 호출을 실행합니다.

읽기 전용이 아닌 메서드는 confirm: true가 제공되지 않으면 차단됩니다. 이는 gripp_call 및 gripp_batch의 각 항목에도 적용됩니다.

예제

이름으로 회사 찾기:

{
  "entity": "company",
  "filters": [
    {
      "field": "company.companyname",
      "operator": "like",
      "value": "%Acme%"
    }
  ],
  "options": {
    "paging": {
      "firstresult": 0,
      "maxresults": 10
    },
    "orderings": [
      {
        "field": "company.companyname",
        "direction": "asc"
      }
    ]
  }
}

비표준 읽기 메서드 호출:

{
  "method": "company.getCompanyByCOC",
  "params": ["12345678"]
}

태그 생성:

{
  "entity": "tag",
  "fields": {
    "name": "Imported"
  },
  "confirm": true
}

메타데이터

커밋된 메타데이터 스냅샷은 공개 API 문서 페이지에서 생성됩니다:

npm run fetch:metadata

Gripp이 API 문서를 업데이트할 때 새로고침하세요.