Rychlý start

Každý skill na emdly je obyčejný soubor .md se stálou URL. Nainstalujte si jeden do Claude Code, nebo připojte celý katalog přes MCP.

# nainstaluje jeden skill do ./skills
npx @emdly/cli add opsmith/jira-ticket-scorer

# nebo připojí katalog ke Claude
claude mcp add --transport http emdly https://emdly.com/mcp

CLI je balíček @emdly/cli na npm: má licenci MIT a s npx není potřeba nic instalovat.

Endpointy s čistým Markdownem

Každý dokument je dostupný jako čistý Markdown na předvídatelné adrese. URL bez verze vždy vrací nejnovější verzi; když záleží na přesném znění, připněte si konkrétní verzi.

GET https://emdly.com/raw/{owner}/{skill}.md        → nejnovější
GET https://emdly.com/raw/{owner}/{skill}@v12.md    → připnutá verze
GET https://emdly.com/raw/{owner}/{skill}/SKILL.md  → formát Agent Skills (vždy s front matter) — pro hermes skills install a Claude Code

200 OK · content-type: text/markdown; charset=utf-8

REST API

Co umí web, zvládne i skript. Čtení je veřejné; zápis vyžaduje bearer token vydaný týmem emdly.

GET    /v1/skills?category=code-review&sort=trending
GET    /v1/skills/{owner}/{skill}
POST   /v1/skills                    → odeslat ke schválení
PUT    /v1/skills/{owner}/{skill}    → nová verze

MCP server

MCP server emdly zpřístupňuje katalog jako nástroje, takže si agenti mohou skilly sami najít a načíst.

search_skills(query, category?)   → seřazené výsledky
get_skill(owner/skill, version?)  → obsah v Markdownu
install_skill(owner/skill)        → soubor + postup krok za krokem: Claude zapíše ~/.claude/skills/<name>/SKILL.md (target=generic → ./skills/<name>.md)
submit_skill(name, body, category?) → po přihlášení: kontroly a AI kontrola bezpečnosti ihned, poté schválení člověkem

# po přihlášení (v prohlížeči nebo MCP tokenem) — soukromá paměť v Brainu
brain_list(brain?, folder?)       → vaše soubory napříč všemi Brainy
brain_search(query, brain?)       → soubory a odpovídající řádky
brain_get(name, brain?)           → obsah v Markdownu
brain_write(name, body, mode?, brain?) → vytvořit / přepsat / připsat, s verzemi
brain_create(name)                → nový vlastní Brain, třeba pro projekt nebo klienta

Skilly podrobně — formát, verze, schvalování: /docs/skills. Brain — pojmenované Brainy, sdílení, role: /docs/brain.

Připojení ke Claude

Jedna URL pro všechny klienty: https://emdly.com/mcp. Hledání, čtení i instalace skillů funguje bez účtu. Když Claude poprvé přistoupí k vašemu soukromému Brainu nebo odešle skill, emdly odpoví „přihlaste se“ a Claude otevře prohlížeč — přihlásíte se přes Google nebo GitHub, schválíte aplikaci a hotovo. Žádné kopírování tokenů; připojení se samo obnovuje a odpojit ho můžete v Nastavení → Připojené aplikace. Agenti a servery bez prohlížeče ho obejdou osobním tokenem — viz níže.

Jak přihlášení vypadá

1. Claude zavolá nástroj, který vás potřebuje (brain_*, submit_skill) → emdly odpoví 401 s OAuth discovery.
2. Claude se zaregistruje jako OAuth klient a otevře https://emdly.com/oauth/authorize v prohlížeči.
3. Přihlásíte se přes Google nebo GitHub (pokud ještě nejste přihlášeni) a schválíte aplikaci pro oprávnění mcp:use.
4. Prohlížeč vás s kódem přesměruje zpět do Claude; Claude ho vymění za token a zavolá nástroj znovu. Příště už vše funguje bez přihlašování.

Claude Desktop a claude.ai

Settings → Connectors → Add custom connector. Název emdly, URL https://emdly.com/mcp, Authentication Required when the server asks (nebo Always required, chcete-li se přihlásit hned). Po kliknutí na Add se konektor objeví pod ikonou nástrojů v každém chatu a přihlášení se zobrazí, jakmile se Claude poprvé zeptáte na váš Brain.

Claude Code

claude mcp add --transport http emdly https://emdly.com/mcp

# v Claude Code: /mcp → emdly → Authenticate otevře prohlížeč (stačí jednou a jen kvůli Brainu a odesílání skillů)
# pak třeba „vypiš soubory v mém Brainu“, „najdi na emdly skill na code review“
# nebo „odešli tento soubor jako skill na emdly“ — skončí ve frontě ke schválení, ne v katalogu

Přidejte --scope user a server bude dostupný v každém projektu, ne jen v aktuálním.

# nebo to nechte na CLI — MCP server (user scope) + soubor s pravidly, který Claude Code čte v každé relaci
npx @emdly/cli setup

setup zapíše ~/.claude/rules/emdly.md: před plánováním úkolu prohledat katalog, před odpovědí na otázku o vašem kontextu prohledat Brain. Instrukce, které posílá MCP server, soupeří s vaším vlastním CLAUDE.md a prohrávají; soubor s pravidly ne.

Bez prohlížeče — osobní token

Pro CI, agenta na serveru, OpenClaw, Hermes na stroji bez grafického rozhraní nebo jakéhokoli klienta, pro kterého je přihlášení v prohlížeči nepraktické, vytvořte token v Nastavení → MCP token (zobrazí se jen jednou) a místo přihlášení ho posílejte v hlavičce Bearer — stejné nástroje, stejná oprávnění, žádný prohlížeč:

# Claude Code
claude mcp add --transport http emdly https://emdly.com/mcp --header "Authorization: Bearer <token>"

# Claude Desktop / claude.ai: Add custom connector → Authentication: None → Request headers
Authorization: Bearer <token>

Chraňte token jako heslo — umožňuje číst a zapisovat váš Brain; pokud unikne, zneplatněte ho v Nastavení.

Hermes Agent

Hermes komunikuje přes MCP pomocí streamable HTTP a přihlášení v prohlížeči zvládne sám (auth: oauth — zaregistruje se jako klient a otevře autorizační stránku, jakmile nástroj poprvé potřebuje vaše přihlášení), takže katalog, submit_skill i váš Brain fungují bez kopírování tokenu. Přidejte server do ~/.hermes/config.yaml a konfiguraci znovu načtěte:

mcp_servers:
  emdly:
    url: "https://emdly.com/mcp"
    auth: oauth                        # přihlášení v prohlížeči při prvním použití; tokeny se ukládají do ~/.hermes/mcp-tokens/
    tools:
      include: [search_skills, get_skill, install_skill, submit_skill, "brain_*"]

# v relaci Hermes
/reload-mcp

Stroj bez grafického rozhraní, nebo se přihlašování v prohlížeči chcete vyhnout? Místo auth použijte osobní token — Hermes doplní ${env:…} z proměnných prostředí a ze souboru ~/.hermes/.env:

mcp_servers:
  emdly:
    url: "https://emdly.com/mcp"
    headers:
      Authorization: "Bearer ${env:EMDLY_MCP_TOKEN}"

Nástroje se zobrazí s předponou názvu serveru (mcp_emdly_search_skills, …). Požádejte Hermes o instalaci skillu a install_skill s target=hermes mu předá soubor i cestu, kam Hermes skilly ukládá — ~/.hermes/skills/<category>/<name>/SKILL.md. Skilly pro Hermes používají formát Agent Skills, takže každý skill z emdly je k dispozici i jako hotový SKILL.md, který nainstalujete úplně bez MCP:

hermes skills install https://emdly.com/raw/opsmith/jira-ticket-scorer/SKILL.md
hermes skills install https://emdly.com/raw/opsmith/jira-ticket-scorer@v3/SKILL.md   # připnutá verze

Varianta SKILL.md vždy obsahuje front matter name, description a version; pokud ho autor vynechal, doplníme ho z katalogu.

OpenClaw

OpenClaw komunikuje se vzdálenými MCP servery přes streamable HTTP a posílá hlavičky, které nastavíte, takže celé nastavení spočívá v osobním tokenu — bez prohlížeče. Uložte token do proměnných prostředí stroje, na kterém běží gateway, a přidejte server:

# token z Nastavení → MCP token, uložený mimo konfigurační soubor
export EMDLY_MCP_TOKEN=<token>

openclaw mcp add emdly --url https://emdly.com/mcp --transport streamable-http \
  --header "Authorization: Bearer ${EMDLY_MCP_TOKEN}"

openclaw mcp doctor --probe        # vypíše search_skills, get_skill, install_skill, brain_*

Nebo totéž zapište do ~/.openclaw/openclaw.json — hodnoty se z proměnných prostředí doplní až za běhu, takže ${EMDLY_MCP_TOKEN} zůstane na disku jen jako zástupný text:

{
  "mcp": {
    "servers": {
      "emdly": {
        "url": "https://emdly.com/mcp",
        "transport": "streamable-http",
        "headers": { "Authorization": "Bearer ${EMDLY_MCP_TOKEN}" },
        "requestTimeoutMs": 20000,
        "toolFilter": { "include": ["search_skills", "get_skill", "install_skill", "brain_*"] }
      }
    }
  }
}

Když vynecháte headers, agent dostane jen nástroje katalogu; nástroje Brainu pak vrátí 401. toolFilter je volitelný a jen omezuje, které nástroje agent vidí. Stejně funguje každý jiný klient, který podporuje streamable HTTP a umí poslat hlavičku: URL https://emdly.com/mcp, hlavička Authorization: Bearer <token>.

Publikování a schválení

Odeslané skilly projdou automatickými kontrolami (formát Markdownu, licence, prompt injection) a pak čekají na schválení člověkem. Schválené skilly se publikují s historií verzí; každá aktualizace prochází stejným procesem.

Časté dotazy