Firstlytics

io.github.firstlytics由 GitHub 帳號 firstlytics 發布v1.0.0更新於 Nov 14, 2026

Your Firstlytics web and product analytics: reports, goals, funnels, users and custom SQL.

已驗證Streamable HTTP可網頁執行資料庫資料與分析商業與電商

概覽

AI 產生的概覽

將助理接入 Firstlytics 網站與產品分析，可查詢報表、漏斗、目標、使用者及自訂 SQL。

可以做什麼
  • 列出網站，讀取或修改網站設定
  • 讀取流量報表：總覽、時間序列、細分、即時訪客、造訪與事件
  • 查看 JS 錯誤、Core Web Vitals、路徑、註解與區隔
  • 管理漏斗與目標，含轉換與流失分析
  • 查詢登入使用者、使用者特徵、留存、活躍使用者與功能使用
  • 執行自訂 SQL，讀取 Search Console 資料
適用情境
適合讓助理直接回答關於自有網站流量與產品使用情況的問題，例如註冊來源，並在不開啟後台的情況下維護目標、漏斗與區隔。
執行需求
可使用 Streamable HTTP 的託管端點並帶上 Authorization bearer 標頭，或使用 npm 套件在本機以 stdio 執行，需 Node.js 20 或以上版本。兩者都需要在組織設定中建立的 API 金鑰，透過 FIRSTLYTICS_API_KEY 或 Authorization 標頭提供；金鑰的作用域決定可用工具。自訂 SQL 需要 Scale 方案。
安裝前請注意
API 金鑰可存取分析資料；若含寫入作用域，助理還能建立、修改、刪除網站、目標、漏斗與成員，並刪除使用者資料。不需要變更時請只授予唯讀作用域。頁面標題、路徑、事件名稱等訪客產生的文字會傳給助理，對其據此提出的建議應謹慎看待。金鑰只會傳送到所設定的伺服器位址。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Firstlytics，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.firstlytics%2Fmcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "firstlytics": {
      "type": "http",
      "url": "https://api.firstlytics.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Firstlytics MCP server

Firstlytics is first-party web and product analytics: cookieless by default, with the tracker on your own domain. This is its Model Context Protocol server: Claude, Cursor and other AI assistants can answer questions such as "Where did last week's signups come from?" with your data, and manage your goals and funnels.

There are two ways to connect, with the same tools:

  • Hosted, at https://api.firstlytics.com/v1/mcp (Streamable HTTP), for clients that connect to remote servers: Claude Code, Cursor, VS Code, Windsurf and others. Nothing to install.
  • This package, @firstlytics/mcp, over stdio, for clients that start local servers, such as Claude Desktop: npx -y @firstlytics/mcp. It is a bridge to the hosted server, so its tools are always the hosted server's.

Both sign in with an organisation API key.

The API key

In Firstlytics, Organization settings → API keys → New key. The key's scopes decide what the assistant can do, and a key limited to some sites sees only those:

ScopeTools
stats:readreports (overview, timeseries, breakdowns, live, visits, events, errors, Web Vitals, journeys, goal conversions, funnel results) and custom SQL (run_query, get_query_schema: Scale plan)
sites:readlist_sites, site settings, funnels, annotations, segments
sites:writecreating, changing and deleting sites, goals and funnels
members:readlist_members
members:writeinviting people (not admins) and choosing which sites a member sees

For an assistant that only reads reports, give it stats:read and sites:read. Add the write scopes only when you want it to change things; it asks before deleting anything.

Set it up

Replace fl_live_... with your key.

Claude Code

bash
claude mcp add --transport http firstlytics https://api.firstlytics.com/v1/mcp \  --header "Authorization: Bearer fl_live_..."

Claude Desktop

Settings → Developer → Edit Config, then in claude_desktop_config.json:

json
{  "mcpServers": {    "firstlytics": {      "command": "npx",      "args": ["-y", "@firstlytics/mcp"],      "env": { "FIRSTLYTICS_API_KEY": "fl_live_..." }    }  }}

Restart Claude Desktop after saving. It needs Node.js 20 or later.

Cursor

In ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project):

json
{  "mcpServers": {    "firstlytics": {      "url": "https://api.firstlytics.com/v1/mcp",      "headers": { "Authorization": "Bearer fl_live_..." }    }  }}

VS Code

In .vscode/mcp.json; VS Code asks for the key the first time and keeps it:

json
{  "inputs": [    { "type": "promptString", "id": "firstlytics-key", "description": "Firstlytics API key", "password": true }  ],  "servers": {    "firstlytics": {      "type": "http",      "url": "https://api.firstlytics.com/v1/mcp",      "headers": { "Authorization": "Bearer ${input:firstlytics-key}" }    }  }}

Other clients

A client that connects to remote servers: https://api.firstlytics.com/v1/mcp, Streamable HTTP, with the header Authorization: Bearer fl_live_....

A client that starts local servers: the command npx -y @firstlytics/mcp, with FIRSTLYTICS_API_KEY in its environment.

Tools

ToolWhat it does
list_sites, get_sitethe sites the key sees, with visitors in the last 24 hours; one site's settings
create_site, update_site_config, delete_siteadd a site, change its settings, delete it
get_overview, get_overview_timeseriesvisitors, visits, page views, bounce rate, duration, over a period and over time
get_breakdowntop pages, sources, countries, devices, events, properties ...
get_live_statsvisitors now and in the last 30 minutes
get_sessions, get_sessionvisits, and every event of one visit
get_events, get_event_namesrecent events; custom events with counts
get_errors, get_web_vitals, get_journeysJavaScript errors, Core Web Vitals, common paths
get_funnels, analyze_funnel, save_funnel, delete_funnelfunnels and where visitors drop off
get_goals, create_goal, update_goal, delete_goalgoals and their conversions
get_annotations, list_segments, apply_segmentannotations, saved segments, a report with a segment
list_members, add_member, update_member_site_accessmembers, invitations, which sites a member sees
get_query_schema, run_querycustom SQL over the site's own data (Scale plan)
get_search_console_status, get_search_console_dataSearch Console: clicks, impressions, CTR and position
get_users, get_user, get_user_traitssigned-in users, one user's profile across days, users by trait
get_retention, get_active_users, get_feature_usageretention cohorts, DAU, WAU, MAU and stickiness, feature adoption
delete_usererase a user for an erasure request (asks for confirm_user_id)

Every tool does what the matching API endpoint does, with the same checks. The user tools read data collected with cookies, so they need a site in a cookie mode; on a cookieless site they find no users.

The full guide: firstlytics.com/docs/settings/mcp-server.

Configuration

Environment variable
FIRSTLYTICS_API_KEYan organisation API key (fl_live_...); required
FIRSTLYTICS_MCP_URLanother server than https://api.firstlytics.com/v1/mcp

Good to know

  • The assistant reads what your visitors left in your data: page titles, paths, referrers, event names. Treat what it suggests from them as you would any text from the web.
  • Delete a key in Organization settings when you no longer use it; the assistant loses access at once.
  • The key is sent only to the server in FIRSTLYTICS_MCP_URL, over HTTPS. This package keeps nothing on disk.

Development

bash
npm installnpm test

The tests run the bridge against a stand-in for the hosted server, in memory and as the firstlytics-mcp command over stdio.

Questions and bugs: GitHub issues or [email protected].

License

MIT, © FunFirst s.r.o.

來源：README.md，提交 70fd7f0

工具

0
該伺服器需要 API 金鑰等憑證，因此 SourceWeft 無法在沒有憑證的情況下讀取其工具，也未收錄。

版本歷史

1
  1. v1.0.0最新Nov 14, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分