TypeHop
Unduh

Pengembang · API key

Referensi API key TypeHop

API key memungkinkan aplikasi AI atau kode Anda sendiri membaca dikte yang tersinkron ke akun TypeHop Anda, dari perangkat mana pun. Kunci bersifat hanya-baca: dapat mencari dan membaca dikte serta kata kustom Anda, tetapi tidak pernah mengubah atau menghapus apa pun. Akses melalui satu endpoint MCP jarak jauh, sehingga aplikasi seperti Claude Code, Cursor, dan Codex berfungsi hanya dengan satu baris pengaturan.

Buat kunci

  1. Buka aplikasi TypeHop di Mac lalu masuk ke Integrations → API keys.
  2. Tekan Create API key dan beri nama sesuai aplikasi atau mesin yang akan menggunakannya, misalnya “Cursor di laptop saya”.
  3. Salin kunci segera. TypeHop hanya menyimpan hash, jadi kunci lengkap hanya ditampilkan sekali. Hilang? Buat yang baru lalu cabut yang lama.

Kunci diawali dengan thp_mcp_. Daftar di aplikasi menampilkan beberapa karakter pertama setiap kunci, kapan dibuat, dan kapan terakhir digunakan. Mencabut kunci akan langsung menghentikan semua aplikasi yang memakainya.

Autentikasi

Kirim kunci sebagai token Bearer pada setiap permintaan. Tidak ada alur OAuth dan tidak ada sesi yang perlu dibuka.

Endpoint
https://api.typehop.com/v1/mcp
Metode
Hanya POST. GET dan DELETE mengembalikan 405.
Header
Authorization: Bearer thp_mcp_YOUR_KEY
Isi
JSON-RPC 2.0, Content-Type: application/json

Kunci yang hilang atau sudah dicabut

HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer realm="typehop-mcp"

{ "jsonrpc": "2.0", "id": null, "error": { "code": -32001, "message": "This token is invalid or was revoked." } }

Hubungkan aplikasi AI

Kebanyakan orang tidak pernah memanggil endpoint secara manual. Aplikasi Mac menampilkan pengaturan persis untuk Claude Code, Cursor, VS Code, Windsurf, Codex, Gemini CLI, Zed, dan Claude Desktop di bawah Connect an app, dengan kunci baru Anda yang sudah terisi. Cuplikan yang sama ada di halaman MCP. Misalnya, Claude Code:

claude mcp add --transport http typehop https://api.typehop.com/v1/mcp --header "Authorization: Bearer thp_mcp_YOUR_KEY"

Klien lain yang mendukung server MCP jarak jauh lewat Streamable HTTP dapat bekerja dengan URL endpoint dan header di atas. Konektor kustom Claude.ai dan ChatGPT memerlukan OAuth, yang belum didukung TypeHop.

Memanggil dari kode

Endpoint ini menggunakan Model Context Protocol: pesan JSON-RPC 2.0 dalam sebuah POST, dengan satu respons JSON sebagai balasan. Sifatnya stateless, jadi tidak ada header sesi dan tidak ada server-sent events. Versi protokol yang didukung: 2025-06-18, 2025-03-26, 2024-11-05.

1. Inisialisasi (opsional, tetapi klien MCP melakukannya)

curl https://api.typehop.com/v1/mcp \
  -H "Authorization: Bearer thp_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0.0"}}}'

2. Daftar tool

curl https://api.typehop.com/v1/mcp \
  -H "Authorization: Bearer thp_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

3. Panggil sebuah tool

curl https://api.typehop.com/v1/mcp \
  -H "Authorization: Bearer thp_mcp_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_dictations","arguments":{"query":"launch plan","limit":5}}}'

Respons · 200

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "[2026-11-03T09:14:22.000Z · Slack · id 3f6c1a2e-8b1d-4c55-9a0e-6b2f7d1e4c90]\nThe launch plan moves to next Tuesday..."
      }
    ],
    "isError": false
  }
}

Setiap dikte dalam hasil diawali baris header: [created at · app · id <id>], lalu teks yang sudah dirapikan. Berikan id itu ke get_dictation untuk mendapatkan transkrip mentah. Anda juga dapat mengirim array berisi hingga 20 pesan dalam satu permintaan; notifikasi (pesan tanpa id) mendapat 202 tanpa isi. ping didukung.

Tool

Setiap tool bersifat hanya-baca dan mengembalikan teks biasa di result.content[0].text.

search_dictations · Cari dikte

Pencarian teks penuh pada semua yang pernah didikte pengguna. Mengembalikan hasil terbaru lebih dulu.

  • query (string, wajib): Kata atau frasa yang dicari.
  • limit (integer 1–50, default 20)

recent_dictations · Dikte terbaru

Dikte terbaru pengguna, opsional hanya dari beberapa hari terakhir.

  • limit (integer 1–50, default 20)
  • days (integer 1–365): Hanya dikte dari N hari terakhir.

get_dictation · Ambil sebuah dikte

Satu dikte berdasarkan id: teks yang sudah dirapikan dan transkrip mentah.

  • id (string, wajib): Id yang ditampilkan pada hasil pencarian atau dikte terbaru.

list_dictionary · Kata kustom

Kata dan ejaan kustom pengguna (nama, istilah khusus).

Tanpa argumen.

Saat sebuah tool tidak dapat menjawab (kueri kosong, id tidak dikenal, kegagalan baca sementara), balasannya tetap berupa hasil 200, dengan isError: true dan sebuah kalimat yang dapat dibaca model.

Error

Error protokol dikembalikan sebagai objek error JSON-RPC: { "code": <number>, "message": "<text>" }.

  • 401 · -32001 Header Authorization tidak ada, atau kunci tidak valid atau sudah dicabut.
  • 400 · -32700 Isi permintaan bukan JSON yang valid.
  • 413 · -32600 Isi permintaan lebih besar dari 256 KB.
  • 200 · -32600 Pesan bukan JSON-RPC 2.0 (tidak ada "jsonrpc": "2.0" atau "method").
  • 200 · -32601 Metode tidak dikenal.
  • 200 · -32602 tools/call menyebut tool yang tidak ada.
  • 500 · -32603 Error server. Coba lagi dengan backoff.

Batasan dan keamanan

Kunci aktif
Hingga 10 per akun. Cabut satu untuk membuat yang lain.
Ukuran permintaan
256 KB per permintaan, hingga 20 pesan per batch.
Hasil
Hingga 50 dikte per panggilan; recent_dictations menelusuri paling jauh 365 hari ke belakang.
Cakupan
Dikte yang tersinkron ke akun Anda, ditambah kata kustom Anda. Tidak ada yang ditulis.
  • Gunakan satu kunci per aplikasi atau mesin, sehingga Anda dapat mencabut satu tanpa mengganggu yang lain.
  • Simpan kunci di komputer atau backend Anda. Jangan pernah menaruhnya di kode browser, bundel aplikasi seluler, atau repositori publik.
  • Kunci yang bocor: cabut di Integrations → API keys. Kunci itu berhenti berfungsi pada permintaan berikutnya.

Pertanyaan: support@typehop.com. Mencari gambaran umum? Lihat API TypeHop.

Other products from us:SmashSend·TidySupport·SuperBuilder·Inbounter·Blossu·KnowledgeSDK