Hubungkan Agent Anda melalui MCP

Pilih metode koneksi Anda

FreeLipSync memperlihatkan titik akhir MCP jarak jauh di https://freelipsync.com/mcp. Ini memberi agen kemampuan pembuatan video dan kredit akun yang sama seperti REST API. Anda harus memiliki akun FreeLipSync yang terdaftar; akses anonim tidak didukung. Gunakan asal staging Anda saat menguji pada staging.

Konfigurasi API Key dan OAuth didukung. Pilih satu sumber kredensial per entri server. File konfigurasi yang ada tetap merupakan cara yang valid untuk terhubung; Anda tidak harus menggunakan OAuth.

Buat kunci lalu salin nilai lengkapnya dari dialog pembuatan. OAuth tidak memerlukan penyalinan kunci. Setiap akun mendukung hingga 5 API Keys dan 5 koneksi OAuth independen. Akses API Key memakai slot kunci, bukan slot koneksi OAuth. Kedua metode berbagi saldo, model, dan batas akun.

Alur otorisasi OAuth

1. Tambahkan HTTPS URL di klien Anda, tanpa header Authorization atau pengaturan API Key.
2. Pilih Connect / Authenticate / Sign in, yang sesuai untuk klien.
3. Di browser, masuk ke akun FreeLipSync Anda dan tinjau klien yang meminta serta izin.
4. Buat koneksi baru (default), atau secara eksplisit pilih koneksi yang sudah ada untuk diganti. Otorisasi yang berhasil pada perangkat lain biasanya dihitung secara terpisah.
5. Izinkan agen membelanjakan kredit API yang Anda beli, lalu otorisasi. Kembali ke klien dan verifikasi alat di bawah ini.

Anda dapat menolak permintaan tersebut. Jika semua slot koneksi 5 digunakan, ganti atau cabut koneksi lama secara eksplisit di konsol Agent; otorisasi baru tidak secara diam-diam menghapus koneksi. Penyegaran token dan menghubungkan kembali otorisasi yang ada tidak menambah slot. Koneksi OAuth dapat menghabiskan kredit akun Anda saat pembuatan dikirimkan.

Kompatibilitas klien OAuth penting: FreeLipSync mendukung metadata identitas klien yang diterbitkan (CIMD) dan klien pra-registrasi, bukan titik akhir pendaftaran dinamis terbuka. Gunakan versi klien yang kompatibel atau ID klien yang ditetapkan jika didukung. Jika klien hanya mendukung pendaftaran dinamis dan gagal masuk, gunakan metode API Key atau hubungi dukungan untuk memeriksa pendaftaran klien.

Kompatibilitas klien dan perbedaan OAuth

Pendaftaran OAuth dan otentikasi token terpisah. FreeLipSync mendukung CIMD atau ID klien pra-registrasi, dengan none + PKCE atau private_key_jwt. Ia memahami rangkaian metode yang didukung CIMD yang lebih baru serta bidang metode tunggal yang lebih lama. Klien yang ditandatangani menggunakan kunci publik yang dipublikasikan secara otomatis; pengguna tidak mengunggah kunci pribadi.

FreeLipSync tidak menawarkan pendaftaran dinamis terbuka (DCR), autentikasi rahasia klien, atau pemberian client_credentials. Jika klien memerlukan DCR, gunakan opsi klien publik yang telah didaftarkan sebelumnya jika tersedia, atau gunakan konfigurasi API Key di klien yang mendukung header Bearer khusus. Dapatkan ID yang ditetapkan dan daftarkan panggilan balik sebenarnya sebelum mengonfigurasinya. ID klien API Key dan OAuth merupakan kredensial yang berbeda.

Codex: file konfigurasi atau OAuth

Tambahkan atau edit server HTTP jarak jauh di bawah Plugins → MCPs di Codex; beberapa versi menggunakan server Settings → MCP. Entri MCP lokal ini mendukung konfigurasi API Key dan terpisah dari entri OAuth plugin yang dihosting yang dijelaskan di atas.

Pilih satu sumber kredensial. Contohnya menggunakan https://freelipsync.com/mcp. Untuk staging, ganti dengan https://staging.freelipsync.com/mcp dan buat kunci di akun staging Anda. Kunci produksi dan staging tidak dapat dipertukarkan.

Opsi A: tempelkan API Key di pengaturan desktop

Gunakan opsi ini jika Anda tidak ingin mengonfigurasi variabel lingkungan. Buat key di Agent console, salin rahasia lengkapnya, lalu isi:

Gunakan satu spasi setelah Bearer; kuncinya sendiri tidak memiliki awalan Bearer. Jangan memberi nama header FLS_API_KEY atau menempelkan rahasia ke Bearer token env var. Simpan dan sambungkan kembali; jika klien masih menggunakan konfigurasi lama, mulai ulang atau buka sesi baru.

Entri ~/.codex/config.toml pribadi yang setara adalah:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"
http_headers = { Authorization = "Bearer YOUR_API_KEY" }

Opsi B: menyediakan API Key melalui variabel lingkungan

Bearer token env var menggunakan nama variabel, bukan rahasia. Setel ke FLS_API_KEY. Variabel tersebut harus ada di lingkungan proses yang menjalankan Codex. Nilainya adalah kunci lengkap tanpa Bearer ; Codex menambahkan awalan.

File konfigurasi pribadi yang sesuai adalah:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"
bearer_token_env_var = "FLS_API_KEY"

Untuk Codex CLI diluncurkan dari terminal:

export FLS_API_KEY='YOUR_API_KEY'
codex mcp list
codex
# Inspect /mcp in the new session.

Mengekspor variabel di terminal lain tidak memperbarui aplikasi desktop yang sudah berjalan. Aplikasi yang diluncurkan dari Dock atau menu Start mungkin juga tidak mewarisi variabel terminal. Jika Anda tidak yakin bagaimana menyediakan lingkungan proses desktop, gunakan opsi A.

Headers membuat header permintaan HTTP. Headers from environment variables membaca nilai header dari variabel lingkungan yang ada. Tidak ada bidang yang membuat variabel lingkungan sistem. Header bernama FLS_API_KEY tidak mengisi pengaturan Bearer, dan placeholder abu-abu seperti MCP_BEARER_TOKEN tidak berarti variabel tersebut telah dikonfigurasi.

Opsi C: otorisasi di browser dengan OAuth

Masukkan URL saja. Biarkan Bearer token env var, Headers, dan Headers from environment variables kosong, termasuk menghapus baris Authorization sebelumnya. Simpan, pilih Authenticate / Sign in jika ditawarkan, masuk ke FreeLipSync dan setujui koneksi. Tidak ada API Key yang perlu dibuat atau ditempel.

Untuk file konfigurasi, simpan saja:

[mcp_servers.freelipsync]
url = "https://freelipsync.com/mcp"

Perintah CLI:

# Run the next line only if this server name does not exist; otherwise edit it.
codex mcp add freelipsync --url https://freelipsync.com/mcp
codex mcp login freelipsync
codex mcp list

Ganti freelipsync di perintah dengan nama server yang Anda simpan. Ketiga blok TOML di atas merupakan alternatif; menyimpan satu entri untuk server. Hapus konfigurasi yang dikunci sebelum beralih ke OAuth: masuk tidak memperbaiki header Authorization yang salah yang masih dikonfigurasi.

Periksa koneksi setelah menyimpan

Di sesi baru, tanyakan: "Hubungi FreeLipSync get_capabilities dan get_usage untuk memeriksa model dan kredit saya. Jangan buat video." Respons akun yang berhasil mengonfirmasi koneksi; nama server yang muncul dalam daftar saja tidak.

Untuk HTTP 401, periksa apakah URL dan kunci berada di lingkungan yang sama, kunci sudah lengkap, header statis adalah Authorization: Bearer YOUR_API_KEY, dan tidak ada variabel Bearer lama atau pengaturan duplikat Authorization yang tersisa. Dengan opsi B, periksa juga lingkungan proses yang sebenarnya meluncurkan klien.

Lihat panduan resmi OpenAI MCP dan referensi konfigurasi untuk definisi bidang.

Claude Code: file konfigurasi atau OAuth

Untuk akses API Key, letakkan entri ini dalam konfigurasi MCP pribadi/lokal atau gabungkan ke dalam .mcp.json untuk proyek tersebut. Variabel lingkungan diperluas sebesar Claude Code. Jauhkan kunci sebenarnya dari konfigurasi bersama dan mulai Claude Code dengan kumpulan variabel.

{
  "mcpServers": {
    "freelipsync": {
      "type": "http",
      "url": "https://freelipsync.com/mcp",
      "headers": {"Authorization": "Bearer ${FLS_API_KEY}"}
    }
  }
}

export FLS_API_KEY='YOUR_API_KEY'
claude mcp list

Untuk OAuth, hapus entri berkunci atau header Authorization-nya terlebih dahulu, tambahkan server URL khusus HTTP, dan autentikasi melalui /mcp dalam sesi Claude Code interaktif:

claude mcp add --transport http --scope user freelipsync https://freelipsync.com/mcp
claude
# In Claude Code, run /mcp and choose Authenticate for freelipsync.

Gunakan satu metode pada satu waktu. Konfigurasi tidak validBearerheader tidak akan diperbaiki dengan masuk melalui alur yang berbeda. Melihat Claude CoderesmiMCPmemandu.

Claude Desktop dan Claude web

Untuk OAuth, buka halaman manajemen Claude Connectors, tambahkan konektor web/jarak jauh khusus bernama FreeLipSync, dan masukkan https://freelipsync.com/mcp. Pilih masuk dan gunakan identitas klien Claude yang dipublikasikan jika tersedia; lengkapi halaman otorisasi FreeLipSync. Suatu organisasi mungkin mengharuskan pemiliknya untuk mengaktifkan konektor terlebih dahulu. Konektor jarak jauh harus mencapai titik akhir HTTPS publik; localhost tidak dapat dijangkau dari cloud Claude. Lihat panduan konektor jarak jauh Claude.

Untuk rute file konfigurasi Claude Desktop yang lebih lama, klien khusus stdio memerlukan jembatan lokal ke titik akhir jarak jauh; menempelkan url jarak jauh ke dalam konfigurasi stdio tidaklah cukup. Dengan Node.js / npx terinstal, gabungkan entri ini ke claude_desktop_config.json (buka dari pengaturan pengembang Desktop) dan mulai ulang Desktop. Ganti placeholder secara lokal dan jaga kerahasiaan file pribadi ini.

{
  "mcpServers": {
    "freelipsync": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://freelipsync.com/mcp",
        "--header", "Authorization:${FLS_AUTH_HEADER}"
      ],
      "env": {"FLS_AUTH_HEADER": "Bearer YOUR_API_KEY"}
    }
  }
}

mcp-remote adalah jembatan kompatibilitas pihak ketiga, bukan paket FreeLipSync. Tinjau instruksi pengelola dan versi yang Anda instal. Argumen headernya mendukung perluasan lingkungan; format di atas juga menghindari spasi di dalam argumen. Lebih memilih dukungan HTTP asli klien bila tersedia. File Desktop ini bukan mekanisme konfigurasi untuk Claude web.

Cursor: file konfigurasi atau OAuth

Untuk akses API Key, gunakan ~/.cursor/mcp.json pribadi Anda (atau proyek .cursor/mcp.json yang berada di luar kendali sumber jika berisi kunci). Ganti placeholder secara lokal. Jangan berasumsi bahwa perluasan lingkungan dari format klien lain berfungsi di versi Cursor yang Anda instal.

{
  "mcpServers": {
    "freelipsync": {
      "url": "https://freelipsync.com/mcp",
      "headers": {"Authorization": "Bearer YOUR_API_KEY"}
    }
  }
}

UntukOAuth, gunakan entri yang sama dengan sajaurl, menghapus objek headers. Di dalamCursor's MCPpengaturan, sambungkan/otentikasi dan selesaikan otorisasi browser jika ditawarkan. Muat ulang atau mulai ulang klien setelah mengubah konfigurasinya, lalu verifikasi alat di dalamnyaAgentmode. Jika alur pendaftaran versi tersebut tidak kompatibel, gunakan konfigurasi Kunci di atas. Melihat CursorresmiMCPinstruksi.

VS Code dan GitHub Copilot

Untuk konfigurasi asli VS Code MCP, buat .vscode/mcp.json dengan masukan kata sandi, bukan kunci asli dalam file:

{
  "inputs": [
    {"type":"promptString","id":"fls-key","description":"FreeLipSync API Key","password":true}
  ],
  "servers": {
    "freelipsync": {
      "type":"http",
      "url":"https://freelipsync.com/mcp",
      "headers":{"Authorization":"Bearer ${input:fls-key}"}
    }
  }
}

Untuk OAuth, hapus inputs dan headers, pertahankan jenis server dan URL. Mulai/hubungkan server dan ikuti perintah otentikasi; pendaftaran klien harus kompatibel seperti dijelaskan di atas. Pilih alatnya dalam mode Agent Copilot dan coba perintah verifikasi di bawah. Format VS Code menggunakan servers, bukan mcpServers klien lain; input interaktif tidak didukung oleh setiap harness Copilot atau konfigurasi portabel. Lihat referensi VS Code MCP.

Verifikasi alat dan coba perintah

Pertama-tama tanyakan kepada agen Anda: "Gunakan FreeLipSync untuk memeriksa model yang tersedia dan saldo kredit saya. Jangan membuat video dulu." Ini harus memanggil get_capabilities dan get_usage, tanpa mengeluarkan kredit. Server yang tercantum dalam file konfigurasi tidak cukup sebagai bukti bahwa otentikasi berhasil.

Lalu coba: "Buat foto pendek Image Fast yang berbicara dari gambar dan audio saya. Dapatkan penawaran terlebih dahulu dan beri tahu saya kreditnya. Tunggu konfirmasi saya sebelum mengirimkan. Jika Anda tidak dapat mengunggah file lokal saya, berikan saya tautan unggah browser." Tetap aktifkan persetujuan klien untuk alat pembelanjaan.

Mengunggah file lokal dari agen

Ada dua jalur file lokal, ditambah impor HTTPS. Jangan melewati jalur lokal sebagai import_asset URL.

• Klien yang dapat membaca berkas dan mengirim HTTP PUT memanggil create_asset_upload dengan kind, filename, content_type, size_bytes, dan idempotency_key. Klien mengunggah byte berkas sebenarnya ke URL yang diterima dengan header yang diberikan, lalu memanggil confirm_asset_upload. Jangan pernah mengirim API Key ke URL penyimpanan bertanda tangan.
• Klien tanpa akses file lokal/HTTP memanggil create_asset_upload_session untuk setiap gambar/video/audio. Anda membuka browser_upload_url, masuk ke akun FreeLipSync yang sama dan mengunggah di browser. Agen mempertahankan asset_id dan melakukan jajak pendapat get_asset; Anda tidak perlu menyalin ID kembali. Jangan membagikan tiket unggahan secara publik.
• Untuk file HTTPS publik yang sudah ada, import_asset dengan kind, url, idempotency_key mulai diimpor. Tunggu sampai siap sebelum mengutip.

Konektor URL saja/cloud tidak mendapatkan akses ke file desktop Anda hanya dengan menggunakan MCP. Misalnya, konektor jarak jauh Claude dijalankan dari cloud-nya, jadi gunakan tautan unggah browser ketika klien tidak dapat mentransfer lampiran Anda ke URL yang ditandatangani.

Kredit, percobaan ulang, dan manajemen koneksi

API dan MCP memakai tarif yang sama: Video Lip Sync / Image Fast 1 kredit/detik; Image Max 2; Image Super / Music Video 3. Durasi audio terverifikasi dibulatkan ke atas ke detik penuh, minimum 5 detik. estimate_generation mengembalikan total_points dan ID estimasi; create_generation menerima quote_id tersebut beserta idempotency_key. Mengunggah, memeriksa penggunaan, dan membuat estimasi tidak menghabiskan kredit. Pembuatan yang sudah diterima tidak dapat dibatalkan; hanya kegagalan pemrosesan yang mengembalikan seluruh cadangan awal. Lihat penagihan dan pemulihan API.

Pertahankan kutipan dan kunci idempotensi yang sama setelah penyerahan yang tidak pasti. Simpan ID pekerjaan yang dikembalikan dan tanyakan; jangan meminta agen untuk “mencoba lagi” dengan membuat tugas lain. Jajak pendapat menggunakan poll_after_seconds, mundur pada Retry-After, dan gunakan list_generations untuk menanyakan beberapa pekerjaan aktif secara bersamaan. API dan MCP berbagi keranjang baca akun, sementara ketiga titik masuk situs web/API/MCP berbagi frekuensi pengiriman dan kapasitas eksekusi video. Situs web dan API/MCP memiliki tunjangan tugas yang belum selesai secara terpisah: Free 1, Starter 3, Pro 10 di setiap kumpulan. Semua kredensial REST/MCP berbagi kumpulan API/MCP. Lihat mengapa menggunakan API/MCP sebagai contoh.

Cabut koneksi Kunci atau OAuth dari konsol Agent. Mencabut kunci akan menghentikan penggunaannya di masa mendatang di setiap klien yang membagikannya, termasuk REST; mencabut koneksi OAuth hanya mempengaruhi koneksi itu. Tidak ada operasi yang membatalkan tugas yang sudah diterima. Menghapus entri klien lokal saja tidak mencabut kredensial di FreeLipSync. Gunakan kunci terpisah atau otorisasi independen ketika Anda memerlukan pencabutan terpisah, bukan untuk meningkatkan konkurensi.

Pemecahan masalah

Pengaturan klien dapat berubah antar versi. Lihat dokumentasi resmi masing-masing klien untuk instruksi terkini. Butuh integrasi HTTP langsung? Baca dokumentasi API.