Перейти к содержимому
ecdsa.com

MCP-сервер

Model Context Protocol (MCP) позволяет ИИ-агентам и ассистентам в IDE вызывать инструменты. Сервер ecdsa.com даёт им доступ к операциям API и справочным каталогам сайта, поэтому ассистент может проверить подпись или объяснить ошибку TLS, а не гадать.

Эндпоинт

https://ecdsa.com/api/mcp

Streamable HTTP без сохранения состояния: никаких сессий, ничего не нужно устанавливать. Подойдёт любой MCP-клиент, который умеет подключаться к удалённым серверам.

API-ключ не нужен: все инструменты работают анонимно. Когда вместе с аккаунтами появятся API-ключи, для вызовов с ключом будет действовать лимит ключа, а не лимит по IP.

Подключение клиента

Claude Code

Первая команда добавляет сервер только для вас; с --scope project он записывается в файл .mcp.json репозитория и работает у всех, кто открывает проект.

Терминал
claude mcp add --transport http ecdsa https://ecdsa.com/api/mcp
claude mcp add --transport http ecdsa --scope project https://ecdsa.com/api/mcp
.mcp.json
{
  "mcpServers": {
    "ecdsa": {
      "type": "http",
      "url": "https://ecdsa.com/api/mcp"
    }
  }
}
С API-ключом

Пригодится, когда API-ключи станут доступны. Не добавляйте ключ в файлы, которые попадают в коммиты.

Добавляйте ключ в локальной области действия (local): там он остаётся на вашем компьютере, а локальная запись с тем же именем заменяет общую только для вас.

Терминал
claude mcp add --transport http ecdsa https://ecdsa.com/api/mcp \
  --header "Authorization: Bearer ecdsa_live_…"

Claude Desktop и claude.ai

Customize → Connectors → Add → Add custom connector. URL: https://ecdsa.com/api/mcp, аутентификация: No sign in. Коннекторы привязаны к аккаунту Claude, поэтому коннектор, добавленный на claude.ai, работает и в Claude Desktop; на тарифе Free можно добавить один пользовательский коннектор.

С API-ключом

Пригодится, когда API-ключи станут доступны. Не добавляйте ключ в файлы, которые попадают в коммиты.

Если в диалоге коннектора есть раздел Request headers, добавьте заголовок Authorization со значением Bearer ecdsa_live_…; если его пока нет, используйте описанный ниже мост stdio с параметром --header. Коннекторы обращаются к API из облака Anthropic, поэтому без ключа все их пользователи делят один лимит по IP.

Cursor

В ~/.cursor/mcp.json для всех проектов или в .cursor/mcp.json для одного:

mcp.json
{
  "mcpServers": {
    "ecdsa": {
      "url": "https://ecdsa.com/api/mcp"
    }
  }
}
С API-ключом

Пригодится, когда API-ключи станут доступны. Не добавляйте ключ в файлы, которые попадают в коммиты.

Ключ лучше хранить в глобальном файле. Cursor подставляет ECDSA_API_KEY из окружения, поэтому переменная должна быть задана.

~/.cursor/mcp.json
{
  "mcpServers": {
    "ecdsa": {
      "url": "https://ecdsa.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ECDSA_API_KEY}"
      }
    }
  }
}

VS Code

В файле .vscode/mcp.json рабочей области или из командной строки:

.vscode/mcp.json
{
  "servers": {
    "ecdsa": {
      "type": "http",
      "url": "https://ecdsa.com/api/mcp"
    }
  }
}
Терминал
code --add-mcp '{"name":"ecdsa","type":"http","url":"https://ecdsa.com/api/mcp"}'
С API-ключом

Пригодится, когда API-ключи станут доступны. Не добавляйте ключ в файлы, которые попадают в коммиты.

VS Code запрашивает ключ при первом запуске сервера и хранит его в своём хранилище секретов.

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "ecdsa-api-key",
      "description": "ecdsa.com API key",
      "password": true
    }
  ],
  "servers": {
    "ecdsa": {
      "type": "http",
      "url": "https://ecdsa.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:ecdsa-api-key}"
      }
    }
  }
}

Клиенты, которые поддерживают только stdio

Подключите их к удалённому серверу через мост mcp-remote:

mcp.json
{
  "mcpServers": {
    "ecdsa": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ecdsa.com/api/mcp"
      ]
    }
  }
}

Инструменты

Сервер предоставляет 11 инструментов; здесь список взят из его собственного реестра — это тот же список, который возвращает tools/list.

  • verify_signatureVerify an ECDSA signature

    Verifies a signature over a message (or a precomputed digest) against a public key. Curves: P-256, P-384, P-521, secp256k1. Signature formats auto-detected: ASN.1 DER or raw r‖s, in hex, base64 or base64url. Public key formats: PEM SPKI ("PUBLIC KEY"), EC JWK, or a bare SEC1 point in hex/base64. A signature that simply does not verify returns valid: false with HTTP 200; only unparseable input yields 400.

    Только чтениеОбласть доступа api · 1 единица квоты за вызов с ключомPOST/v1/verify

  • convert_signatureConvert a signature between DER and raw r‖s

    Decodes a signature (DER or raw, auto-detected; hex/base64/base64url) and returns both encodings plus r, s and the high-S flag. normalize: "low-s" replaces a high-S s with n − s. Warnings list DER canonicality deviations (BER lengths, missing 0x00 pads, trailing bytes) and curve-ambiguity notes.

    Только чтениеОбласть доступа api · 1 единица квоты за вызов с ключомPOST/v1/convert

  • decode_jwtDecode a JWT (no signature check)

    Decodes a compact JWS token: header, payload, enriched exp/iat/nbf time claims and a classification of the algorithm. The signature is NOT verified — the response carries verified: false explicitly. Use /v1/jwt/verify to check ES* signatures.

    Только чтениеОбласть доступа api · 1 единица квоты за вызов с ключомPOST/v1/jwt/decode

  • verify_jwtVerify an ES256/ES384/ES512 JWT signature

    Verifies the token's ECDSA signature against a public key (PEM SPKI, EC JWK, or bare SEC1 point). Non-ECDSA algorithms (HS*, RS*, PS*, EdDSA, ES256K, none) return 400 with code unsupported_algorithm. A signature that fails verification returns valid: false with HTTP 200. Time claims are noted in explanations but do not affect valid.

    Только чтениеОбласть доступа api · 1 единица квоты за вызов с ключомPOST/v1/jwt/verify

  • decode_certificateDecode an X.509 certificate or chain

    Accepts PEM (one or more CERTIFICATE blocks — a whole chain works) or a single DER certificate as base64/hex. Returns a structured summary per certificate — subject, issuer, validity, key and signature algorithms, SAN, key usage, fingerprint — plus assessments (weak hashes, expiry, CA/Browser Forum lifetime limits, post-quantum notes).

    Только чтениеОбласть доступа api · 1 единица квоты за вызов с ключомPOST/v1/cert/decode

  • get_domain_healthTLS signature-health grade for a domain

    Connects to the domain on port 443, examines the served certificate chain, key and signature algorithms, protocol versions and lifetimes, and returns a letter grade with findings, plus the leaf certificate's expiry and key algorithm as structured fields. Results are cached for 1 hour. Only public DNS hostnames are accepted — IP addresses, single-label names and private/reserved addresses are refused. Extra rate limit: 10 requests/minute per IP. A fresh scan can take several seconds.

    Только чтение; подключается к указанному вами хостуОбласть доступа scan · 5 единиц квоты за вызов с ключомGET/v1/health/{domain}

  • explain_errorExplain an error message

    Looks up an error message from a cryptography, TLS, certificate, JWT, SSH, code-signing or Web3 library in the ecdsa.com error catalog (299 messages, reproduced against the libraries that print them) and returns what it means, its likely causes and step-by-step fixes with code. Paste the message as printed; a whole log excerpt or stack trace works too. Never include private keys or secrets: input containing a private key is refused.

    Только чтениеОбласть доступа api · 1 единица квоты за вызов с ключом

  • lookup_oidLook up an object identifier (OID)

    Resolves an ASN.1 object identifier used in X.509 certificates, CSRs, CMS/PKCS#7, PKCS#8/#12 and post-quantum PKI against the ecdsa.com OID catalog (938 identifiers: curated, IANA SMI arcs, CCADB EV policies). Accepts a dotted OID, its DER encoding in hex, or a name such as prime256v1 or ecdsa-with-SHA256; returns the name, aliases, category, DER encoding, OpenSSL names and references. Unknown OIDs still get their DER encoding and nearest known ancestor.

    Только чтениеОбласть доступа api · 1 единица квоты за вызов с ключом

  • lookup_algorithmLook up a cryptographic algorithm identifier

    Resolves an algorithm identifier against the IANA registries for JOSE and COSE (algorithms, key types, curves), TLS (cipher suites, signature schemes, supported groups), SSH, DNSSEC and HPKE: what it is, its code point, recommendation status, parameters (curve, hash, key size), names in OpenSSL/GnuTLS/NSS and the defining RFCs. Accepts names (ES256, TLS_AES_128_GCM_SHA256, ECDHE-ECDSA-AES128-GCM-SHA256, ecdsa-sha2-nistp256, X25519MLKEM768) or code points (-7, 0x0403, 13); `registry` narrows the search.

    Только чтениеОбласть доступа api · 1 единица квоты за вызов с ключом

  • lookup_curveLook up an elliptic curve

    Describes a named elliptic curve from the ecdsa.com curve catalog (54 curves, each checked arithmetically): its names in every standard (SEC 2, NIST, ANSI X9.62, JOSE/COSE, SSH, TLS), OIDs with DER encoding, domain parameters, security level, status (recommended to broken) and where it is used. Accepts any spelling — P-256, secp256r1, prime256v1, nistp256, X25519, Ed25519, brainpoolP256r1 — or the curve's OID.

    Только чтениеОбласть доступа api · 1 единица квоты за вызов с ключом

  • glossaryDefine a cryptography term

    Defines a term from the ecdsa.com glossary (302 terms on signatures, JOSE, PKI, TLS, email authentication, Web3, post-quantum cryptography, identity and supply chain): a one-sentence definition, the explanation from the term's page, references to the standards and related terms, tools and errors.

    Только чтениеОбласть доступа api · 1 единица квоты за вызов с ключом

Лимиты

Анонимные вызовы расходуют общий лимит REST API: 60 запросов в минуту с одного IP и ещё 10 в минуту для get_domain_health, чьи настоящие сканирования к тому же расходуют общие лимиты сканирований. Облачные клиенты (коннекторы claude.ai и Claude Desktop) обращаются к API из облака Anthropic, поэтому их пользователи расходуют один и тот же лимит по IP и при интенсивном использовании получают rate_limited.

Закрытые ключи

Аргументы с данными закрытого ключа (блок PEM PRIVATE KEY, ключ OpenSSH, SSH2 или PuTTY, JWK с параметром «d») отклоняются с кодом private_key_rejected раньше любой другой обработки — так же, как в REST API. Аргументы никогда не записываются в логи.