DeepScript

Integracja

Serwer MCP – agenci AI czytają Twoje transkrypcje bezpośrednio

Claude Desktop, Cursor, Zed i inne klienty MCP rozmawiają bezpośrednio z Twoją biblioteką DeepScript. Bez kopiowania-wklejania, bez chmury zewnętrznej.

Zamiast budować własne endpointy do streszczania, tłumaczenia czy wyszukiwania, DeepScript udostępnia pełnoprawny serwer MCP. Klienci AI tacy jak Claude Desktop, Claude Code czy Cursor łączą się przez Bearer auth z `https://mcp.deepscript.com` i mogą następnie przeszukiwać Twoje transkrypcje, pobierać pojedyncze lub je streszczać – z wybranym przez siebie LLM. Udostępnione są trzy narzędzia: `search_transcripts` (wyszukiwanie pełnotekstowe w Twojej bibliotece), `get_transcript` (pełna treść transkrypcji wraz ze znacznikami czasu dla słów) i `list_recent` (ostatnich N transkrypcji). Serwer MCP jest częścią planu Pro (22 €/miesiąc), ponieważ znosi domyślną 30-dniową retencję i odblokowuje nieograniczony ruch agentów. Tokeny uwierzytelniające to te same klucze API `ds_live_`, których używa REST API.

Co możesz zbudować

  • Zapytaj Claude'a w aplikacji desktopowej: „Jak nazywał się dostawca na zeszłotygodniowym spotkaniu?” – a Claude przeszuka Twoje transkrypcje.
  • Pozwól agentowi w IDE streścić odcinki podcastów bez ich kopiowania.
  • Wyodrębniaj cytaty z wywiadów za pomocą agenta i zapisuj je w notatkach Markdown (np. w Cursor lub Zed).
  • Audyty zgodności: pozwól agentowi sprawdzić, czy określone terminy pojawiły się w zarchiwizowanych spotkaniach.
  • Wyszukiwanie obejmujące wiele nagrań: „Znajdź wszystkie spotkania, na których rozmawiano o Projekcie X.”

Przykłady kodu

Claude Desktop – claude_desktop_config.jsonJSON
{
  "mcpServers": {
    "deepscript": {
      "type": "http",
      "url": "https://mcp.deepscript.com",
      "headers": {
        "Authorization": "Bearer ds_live_xxx"
      }
    }
  }
}
Cursor / Zed – mcp.jsonJSON
{
  "servers": {
    "deepscript": {
      "transport": "http",
      "url": "https://mcp.deepscript.com",
      "auth": {
        "type": "bearer",
        "token": "ds_live_xxx"
      }
    }
  }
}
Schemat narzędzi (udostępniany przez serwer)JSON
{
  "tools": [
    {
      "name": "search_transcripts",
      "description": "Full-text search across the user's transcript library. Returns the top N hits with snippet, transcriptId and createdAt.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": { "type": "string" },
          "limit": { "type": "integer", "default": 10, "maximum": 50 }
        },
        "required": ["query"]
      }
    },
    {
      "name": "get_transcript",
      "description": "Return the full text and word-level metadata for one transcription.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "transcriptId": { "type": "string", "format": "uuid" },
          "includeWords": { "type": "boolean", "default": false }
        },
        "required": ["transcriptId"]
      }
    },
    {
      "name": "list_recent",
      "description": "List the N most recent transcriptions with filename, duration and createdAt.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "limit": { "type": "integer", "default": 20, "maximum": 100 }
        }
      }
    }
  ]
}

Konfiguracja w kilku krokach

  1. 1

    Aktywuj plan Pro

    Serwer MCP jest dostępny tylko w planie Pro (22 €/miesiąc). Dokonaj aktualizacji w panelu rozliczeń. Pro jednocześnie znosi automatyczne usuwanie po 30 dniach, dzięki czemu Twój agent może przeszukiwać także starsze transkrypcje.

  2. 2

    Użyj klucza API jako tokena Bearer

    Wygeneruj zwykły klucz `ds_live_` w panelu. Ten sam klucz uwierzytelnia wywołania MCP i REST. Zalecenie: utwórz dedykowany klucz MCP z własną etykietą, dzięki czemu będziesz mógł go odwołać oddzielnie.

  3. 3

    Skonfiguruj klienta MCP

    Dodaj pokazany powyżej wpis serwera w Claude Desktop, Cursor lub Zed. Uruchom ponownie klienta. Trzy narzędzia `search_transcripts`, `get_transcript` i `list_recent` pojawią się automatycznie w wyborze narzędzi.

  4. 4

    Używaj go na czacie

    Rozmawiaj z agentem w języku naturalnym. Sam wybiera odpowiednie narzędzie. Przykład: „Poszukaj w moich transkrypcjach wszystkich wzmianek o 'prognozie Q3'.” – agent wywołuje `search_transcripts({ query: 'Q3 forecast' })`.

Często zadawane pytania

Dlaczego MCP jest dostępny tylko w planie Pro?

Agenci często wykonują wiele zapytań na rozmowę i potrzebują dostępu do starszych transkrypcji. Pro znosi domyślną 30-dniową retencję i zwalnia wywołania MCP ze zwykłego limitu zapytań. Do okazjonalnego użytku wystarczy endpoint REST w trybie pay-per-use.

Jakie transporty obsługuje serwer?

Obecnie transport HTTP (Server-Sent Events dla odpowiedzi strumieniowych). stdio nie jest obsługiwane, ponieważ serwer działa zdalnie. Większość klientów (Claude Desktop od wersji 0.7, Cursor, Zed) obsługuje MCP po HTTP od razu.

Czy dostawcy AI widzą moje transkrypcje?

Tak – gdy Twój lokalny agent wczyta transkrypcję przez `get_transcript`, wysyła ją jako kontekst do LLM (np. Anthropic, OpenAI). Aby tego uniknąć, uruchom lokalnego klienta LLM (np. Ollama przez adapter Claude Code) w połączeniu z DeepScript MCP – wtedy dane nigdy nie opuszczą Twojej maszyny ani naszego niemieckiego serwera.

Jaka jest dostępność serwera MCP?

Serwer MCP działa w tym samym klastrze Hetzner co REST API, z naszym standardowym SLA na poziomie 99,9%. Status i incydenty znajdziesz na deepscript.com/status. W razie awarii agent kończy działanie w sposób kontrolowany – wywołania narzędzi zwracają jasny komunikat o błędzie.

Czy mogę samodzielnie wywoływać narzędzia MCP, bez klienta AI?

Technicznie tak – MCP to otwarty protokół JSON-RPC, możesz wywoływać narzędzia przez HTTP/curl. Do czysto serwerowych integracji wygodniejsze jest jednak zwykłe REST API, ponieważ jest typowane OpenAPI i nie jest zorientowane na agentów.

Gotowy, aby wdrożyć to na produkcję?

Załóż konto, wygeneruj klucz API i działaj. Trzy transkrypcje za darmo na test. Pełna dokumentacja OpenAPI 3.1 pod api.deepscript.com/docs.

Serwer MCP dla transkrypcji – dostęp Claude & ChatGPT | DeepScript