Bridge Town

Bridge Town Konektor MCP

Bangun model keuangan sebagai kode. Eksekusi cloud, GSheets MCP, kontrol versi, kolaborasi.

Repositori ini berisi dokumentasi publik dan metadata registri untuk konektor Bridge Town MCP yang dihosting. Implementasi server produksi bersifat proprietary dan dioperasikan oleh Bridge Town.

• Situs web: https://bridgetown.builders
• Aplikasi: https://app.bridgetown.builders
• Dokumentasi: https://docs.bridgetown.builders
• Endpoint MCP: https://api.bridgetown.builders/mcp
• Transport: MCP Streamable HTTP
• Autentikasi: OAuth untuk alur konektor yang dihosting; token bearer untuk klien yang memerlukan konfigurasi manual

Apa yang Dilakukan Bridge Town

Bridge Town adalah platform pemodelan keuangan native MCP dan berversi git untuk tim FP&A dan pemimpin keuangan. Agen AI menggunakan alat Bridge Town untuk membuat proyek, menulis file model Python, menjalankan model di sandbox cloud terisolasi, melakukan kueri data, menulis output ke Google Sheets, membuat dasbor, membuat cabang skenario, dan berkolaborasi dengan rekan tim.

Claude.ai adalah jalur koneksi paling umum dan menggunakan OAuth. Claude Code, Claude Desktop, Codex, OpenCode, Cursor, dan klien MCP kustom dapat terhubung ke endpoint Streamable HTTP yang sama dengan token API Bridge Town.

Bridge Town tidak menjalankan LLM sisi server atau memproksi prompt Anda. Klien AI dan penyedia model pilihan Anda menjalankan percakapan; Bridge Town menerima panggilan alat MCP terstruktur.

Hubungkan

Claude.ai

1. Buka Claude.ai.

2. Buka Sesuaikan -> + -> Tambah konektor kustom.

3. Tempel:

   https://api.bridgetown.builders/mcp
   

4. Beri nama konektor Bridge Town.

5. Setujui prompt OAuth Bridge Town.

Tidak diperlukan token API untuk Claude.ai.

Klien MCP Generik

Untuk klien yang mendukung Streamable HTTP plus header:

{
  "mcpServers": {
    "bridge-town": {
      "transport": {
        "type": "http",
        "url": "https://api.bridgetown.builders/mcp",
        "headers": {
          "Authorization": "Bearer btk_YOUR_TOKEN"
        }
      }
    }
  }
}

Buat token dari https://app.bridgetown.builders/connect. Token dimulai dengan btk_ dan dapat dicabut dari halaman yang sama.

Untuk klien yang hanya mendukung konfigurasi MCP berbasis spawn, gunakan mcp-remote:

{
  "mcpServers": {
    "bridge-town": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.bridgetown.builders/mcp",
        "--header",
        "Authorization: Bearer btk_YOUR_TOKEN"
      ]
    }
  }
}

Lihat Memulai untuk petunjuk penyiapan lebih lengkap, alur kerja Google Sheets, keterampilan, dan pemecahan masalah.

Permukaan MCP

Bridge Town mengekspos permukaan MCP produksi untuk alur kerja pemodelan keuangan:

• 75 alat di seluruh proyek, model, proses, data, Google Sheets, dasbor, cabang, pull request, berbagi, templat, penagihan, dan penemuan metadata
• Sumber daya MCP termasuk health://status, skills://, skill://{name}, templates://, dan template://{name}
• Prompt alur kerja dan templat keterampilan untuk tugas FP&A umum

Untuk permukaan alat yang besar, mulailah dengan alat penemuan ini:

• search_tools - temukan alat atau keterampilan Bridge Town yang tepat untuk suatu tugas
• get_tool - ambil skema alat lengkap
• get_skill - jembatan kompatibilitas untuk klien yang tidak dapat membaca sumber daya MCP

Metadata Registri

Manifes registri kanonis untuk daftar publik ini adalah server.json. Ini menunjuk ke server MCP jarak jauh yang dihosting:

https://api.bridgetown.builders/mcp

Repositori ini ada agar direktori MCP yang memerlukan URL GitHub dapat menautkan ke sumber dokumentasi dan metadata publik yang stabil tanpa mengharuskan Bridge Town untuk membuka sumber server komersialnya.

Shim Stdio Lokal

Sebagian besar klien yang dihosting harus terhubung langsung ke endpoint Streamable HTTP. Untuk registri atau host MCP lokal yang memerlukan biner stdio, repositori ini juga menyediakan shim minimal:

BRIDGE_TOWN_API_TOKEN=btk_YOUR_TOKEN npx github:Bridge-Town/financial-modeling-mcp

Shim ini mengekspos bridge-town-mcp melalui stdio dan meneruskan pesan MCP JSON-RPC ke:

https://api.bridgetown.builders/mcp

Konfigurasi:

Variabel	Diperlukan	Deskripsi
BRIDGE_TOWN_API_TOKEN	ya	Token API Bridge Town dari https://app.bridgetown.builders/connect
BRIDGE_TOWN_MCP_URL	tidak	Timpa URL MCP yang dihosting, terutama untuk pengembangan lokal

Shim tidak membaca atau menulis file lokal dan tidak memunculkan proses anak. Ini hanya membuat permintaan HTTPS ke API Bridge Town MCP.

Keamanan

Bridge Town terisolasi per penyewa, didukung OAuth, dan dirancang untuk data keuangan. Eksekusi model keuangan berjalan dalam kontainer terisolasi tanpa jaringan keluar. Akses Google Sheets menggunakan cakupan drive.file Google sehingga Bridge Town hanya dapat mengakses Sheets yang dipilih pengguna melalui alur Bridge Town atau Sheets yang dibuat oleh Bridge Town.

Laporkan masalah keamanan secara pribadi. Jangan buka isu GitHub publik untuk kerentanan. Lihat SECURITY.md.