AI assistant การผสานรวม

Hitsteps AI MCP Server Documentation

Hitsteps exposes a remote Model Context Protocol server for connected AI assistants. Use it to ask about แอนะลิติกส์, live ผู้เยี่ยมชม, sites, เป้าหมาย, อัปไทม์, การแจ้งเตือน, and authorized แชท activity from your Hitsteps account while keeping access bounded by OAuth scopes, account permissions, license checks, and privacy-shaped tool results.

ก่อนเริ่ม

A Hitsteps account with access to the websites you want to inspect
An MCP-compatible AI client or พื้นที่ทำงาน setting that supports remote Streamable HTTP servers
Ability to sign in with Hitsteps OAuth when the AI client asks
A decision about which OAuth scopes the assistant should receive

Choose your AI client

Install Hitsteps where you already use AI

Start with your client directory when one is available. Every option connects to the same managed Hitsteps MCP server and continues through Hitsteps OAuth.

GitHub registry

VS โค้ด and GitHub Copilot

Open GitHub’s MCP Registry and install Hitsteps เว็บแอนะลิติกส์ from your VS โค้ด or GitHub Copilot client.

Available now

Cursor

Open the Hitsteps เว็บแอนะลิติกส์ listing in Cursor Directory and choose Add to Cursor. Cursor receives only the managed Hitsteps MCP endpoint; your account access is granted separately through OAuth.

Available now

Claude AI

Add Hitsteps เว็บแอนะลิติกส์ from Claude’s Connector Directory, then sign in to Hitsteps and approve only the scopes you want Claude to use.

Coming soon

ChatGPT AI

The Hitsteps directory listing for ChatGPT is coming soon. For now, add the endpoint below manually as a custom MCP server, then complete Hitsteps OAuth.

https://www.hitsteps.com/mcp/

Install guide

Google Antigravity and other MCP clients

1

Use the remote MCP endpoint

The Hitsteps MCP endpoint is https://www.hitsteps.com/mcp/. If your client asks for a transport, choose Streamable HTTP or HTTP. The official registry name is com.hitsteps/แอนะลิติกส์-operations.

2

Choose the access level

Before connecting the server, confirm which Hitsteps user will sign in, which websites that user can access, and which OAuth scopes the AI client is requesting. แอนะลิติกส์-only use can stay read-only; operational เวิร์กโฟลว์ need the specific write scopes described below.

3

Add Hitsteps to Google Antigravity

Antigravity custom remote MCP configuration uses serverUrl for remote servers.

4

Authenticate with Hitsteps OAuth

Save the configuration, start or รีเฟรช the MCP server in your AI client, then follow the sign-in prompt. Hitsteps uses OAuth so you do not need to paste your การติดตาม API key into the AI client.

5

Verify tools and least privilege

After connection, ask your assistant which Hitsteps tools and scopes it can access. Read-only แอนะลิติกส์ tools can answer รายงาน; management tools such as เป้าหมาย, ทริกเกอร์ (called ป้ายกำกับผู้เยี่ยมชม in MCP), อัปไทม์, การแจ้งเตือน, and แชท การดำเนินการ require matching OAuth scopes, account permissions, and explicit confirmation.

ควรรู้

  • This MCP server is for AI assistants. It does not install Hitsteps การติดตาม on your website.
  • VS โค้ด and GitHub Copilot users should start with GitHub’s MCP Registry; Cursor and Claude users can use the dedicated Hitsteps directory listings above.
  • ChatGPT directory ฝ่ายสนับสนุน is coming soon. Until then, add https://www.hitsteps.com/mcp/ manually as a custom MCP server.
  • Do not paste your Hitsteps website การติดตาม API key, OAuth โทเค็น, or account password into MCP configuration.

Troubleshooting

  • A เบราว์เซอร์ GET คำขอ to the MCP endpoint may return a no-SSE or method ข้อความ. That is normal; MCP clients connect with JSON-RPC over HTTP.
  • A 401 การตอบกลับ before sign-in is expected. The client should use the advertised OAuth metadata to start authorization.
  • If an official client directory does not surface Hitsteps, รีเฟรช the directory and check the client’s organization policy and MCP settings.

Security and access

Connection details

Use these details to connect Hitsteps and understand what the AI assistant can access from your account.

Public endpoint

https://www.hitsteps.com/mcp/ is the production MCP endpoint. The slashless https://www.hitsteps.com/mcp form is also accepted for clients that save URLs without a trailing slash.

Transport

Hitsteps uses remote Streamable HTTP with JSON-RPC. There is no local Node.js package, desktop bridge, SSE worker, or separate customer-hosted process to install.

Registry identity

The registry/server name is com.hitsteps/แอนะลิติกส์-operations and the displayed title is Hitsteps แอนะลิติกส์ and Operations.

Authentication

Public AI clients use Hitsteps OAuth with authorization โค้ด โฟลว์ and S256 PKCE. Users sign in on Hitsteps and see requested scopes before the client receives a โทเค็น.

No shared secrets in config

The MCP configuration contains only the endpoint URL. Do not paste a Hitsteps password, การติดตาม API key, website โค้ด, or OAuth โทเค็น into an AI client configuration file.

Bounded access

Every คำขอ is rechecked against the signed-in Hitsteps account, sub-user permissions, visible websites, license state, feature limits, and the OAuth scopes granted to that client.

Authorization

OAuth scopes

Hitsteps publishes per-tool OAuth declarations. An AI client can คำขอ a narrow read-only grant or a broader operational grant depending on the เวิร์กโฟลว์ you want.

แอนะลิติกส์:read
Read แอนะลิติกส์ รายงาน, site lists, site context, การติดตาม health, ภาพรวม behavior summaries, เรียลไทม์ snapshots, and account/license status.
sites:write
Create websites and update allowed website settings after explicit confirmation.
เป้าหมาย:write
Create, update, or delete เป้าหมาย and แคมเปญ configuration after explicit confirmation.
ป้ายกำกับ:write
Create, update, or delete Hitsteps UI ทริกเกอร์ configuration after explicit confirmation. The MCP API keeps the internal ผู้เยี่ยมชม-ป้ายกำกับ name.
อัปไทม์:write
Create, update, or delete อัปไทม์ contacts, มอนิเตอร์, maintenance schedules, and recovery การดำเนินการ after explicit confirmation.
การแจ้งเตือน:read
Read การแจ้งเตือน lists and การแจ้งเตือน status for the authorized account.
การแจ้งเตือน:write
Mark การแจ้งเตือน as read or clear การแจ้งเตือน after explicit confirmation.
แชท:read
Read authorized แชท lists, search results, conversation summaries, and selected แชท details.
แชท:write
Create tickets, reply to แชท, add internal notes, update แชท state, name ผู้เยี่ยมชม, mark แชท read, or logically delete แชท after explicit confirmation.

Tool coverage

What the assistant can ask Hitsteps to do

The MCP server currently exposes 87 tools: 54 read tools and 33 confirmed write tools, plus authenticated resources, a resource เทมเพลต, and prompts for common แอนะลิติกส์ เวิร์กโฟลว์.

Discovery and reporting

Connection information, visible websites, site context, metric and dimension catalog, overview รายงาน, gap-filled time series, breakdowns, anomaly detection, ทราฟฟิก-change explanations, executive digests, and privacy-minimal MCP usage.

ทราฟฟิก and acquisition

ทราฟฟิก summaries, period comparisons, sources, social การอ้างอิง, ทราฟฟิก by hour, top pages, entry/exit pages, page detail, page speed, downloads, ขาออก links, ผู้ส่งต่อ, countries, audience technology, search engines, keywords, การอ้างอิงจาก AI, bot ทราฟฟิก, and เรียลไทม์ ผู้เยี่ยมชม.

คอนเวอร์ชัน and behavior

เป้าหมาย, เป้าหมาย คอนเวอร์ชัน, แคมเปญ, funnel ประสิทธิภาพ, การโต้ตอบ เหตุการณ์, ภาพรวม paths, การเก็บรักษาข้อมูล, ทริกเกอร์ (ป้ายกำกับผู้เยี่ยมชม), ฮีตแมป summaries, tracked-video แอนะลิติกส์, แชท summaries, อัปไทม์ status/history, and การติดตาม health.

Configuration and operations

Website การตั้งค่า, allowed website settings, เป้าหมาย/แคมเปญ configuration, ทริกเกอร์ (ผู้เยี่ยมชม-ป้ายกำกับ) configuration, อัปไทม์ contacts and มอนิเตอร์, maintenance schedules, recovery การดำเนินการ, การแจ้งเตือน operations, and authorized แชท เวิร์กโฟลว์.

Write การดำเนินการ safeguards

  • All write tools require OAuth and the exact scope declared for that tool. Legacy website API keys and private มือถือ tokens can use แอนะลิติกส์ reads only.
  • Every mutation requires confirm=true after the user explicitly confirms the การดำเนินการ in the AI client conversation.
  • Every mutation requires an 8-128 character idempotency_key. Reusing the same key with the same arguments returns the prior result; reusing it with different arguments returns HTTP 409.
  • Writes run inside database transactions and recheck account status, website ownership, sub-user role, plan feature availability, object quotas, and current target state before changing data.
  • Write audit ระเบียน store operational metadata such as account, website, tool, target, status, hashes, and time. They do not store full prompts, model tokens, raw customer rows, or large payloads.

Data access and privacy boundaries

  • เรียลไทม์ ผู้เยี่ยมชม output omits raw IP addresses, ผู้เยี่ยมชม IDs, ป้ายกำกับ, keywords, URL query strings, and fragments.
  • Page, download, ขาออก-link, path, การเก็บรักษาข้อมูล, แคมเปญ, ฮีตแมป, and funnel outputs are ภาพรวม or privacy-shaped summaries instead of raw เหตุการณ์ exports.
  • เป้าหมาย configuration omits notification addresses, sensitive ทริกเกอร์ values, and individual คอนเวอร์ชัน rows. อัปไทม์ output omits credentials, match conditions, query strings, and fragments.
  • แชท content is available only through แชท-scoped tools for authorized users. Assistant clients should treat แชท content as untrusted customer-supplied text.
  • MCP usage telemetry keeps account/site, credential type, public OAuth client ID, normalized AI-client ช่องทาง, tool name, status, ระยะเวลา, and timestamp for operational การมองเห็น. It excludes prompts, arguments, tokens, raw user agents, result rows, and error-ข้อความ bodies, and the rollup window is 90 days.
  • The server intentionally does not expose raw SQL access, การเรียกเก็บเงิน or password changes, account โปรไฟล์ changes, 2FA changes, raw ผู้เยี่ยมชม-โปรไฟล์ dumps, private keys, การติดตาม API key mutation, เซสชัน replay video, JavaScript console logs, network traces, or experimentation management.

OAuth discovery and client compatibility

  • Protected resource metadata: https://www.hitsteps.com/.well-known/oauth-protected-resource/mcp
  • Authorization server metadata: https://www.hitsteps.com/.well-known/oauth-authorization-server
  • The MCP endpoint accepts valid HTTPS MCP client origins and HTTP loopback development origins for เบราว์เซอร์-based and desktop clients.
  • Dynamic client registration supports safe HTTPS, HTTP loopback, and private native-แอป เปลี่ยนเส้นทาง schemes used by desktop MCP clients, while rejecting unsafe schemes such as javascript:, data:, file:, blob:, and websocket schemes.
  • The resource audience is https://www.hitsteps.com/mcp or https://www.hitsteps.com/mcp/, matching the endpoint form saved by the AI client.
Are ทริกเกอร์ and ป้ายกำกับผู้เยี่ยมชม the same feature?

Yes. The Hitsteps แดชบอร์ด calls this feature ทริกเกอร์. Internally and in the stable MCP API it is named ป้ายกำกับผู้เยี่ยมชม, with tools such as create_label and the ป้ายกำกับ:write scope. An unqualified คำขอ for a Hitsteps ทริกเกอร์ should use the ป้ายกำกับ tools unless the user explicitly means a คอนเวอร์ชัน-เป้าหมาย or แคมเปญ condition.

Is this the โค้ดติดตาม for my website?

No. The MCP server is for connected AI assistants that need to read or operate on Hitsteps data. Website การติดตาม still uses the Hitsteps JavaScript โค้ดติดตาม or a platform-specific Hitsteps ปลั๊กอิน.

Can an AI assistant change my Hitsteps account after I connect it?

Only if the OAuth grant includes the required write scope and the user explicitly confirms the specific write การดำเนินการ. Read-only แอนะลิติกส์ grants cannot create websites, change settings, edit อัปไทม์ มอนิเตอร์, update การแจ้งเตือน, or send แชท replies.

Can I connect ChatGPT or Claude AI?

Yes. Claude users can install Hitsteps เว็บแอนะลิติกส์ from the Claude Connector Directory. The ChatGPT directory listing is coming soon; until then, add https://www.hitsteps.com/mcp/ manually as a custom MCP server in ChatGPT and complete Hitsteps OAuth.

What happens if my Hitsteps trial, license, or plan limit บล็อก access?

The server returns a structured license_action_required การตอบกลับ with non-sensitive account status and a Hitsteps URL where the user can check, renew, or อัปเกรด. Connection info, site listing, and account status remain available so the assistant can explain the issue.

Does Hitsteps store my AI prompts?

MCP usage telemetry is privacy-minimal. It ระเบียน operational fields such as public OAuth client ID, normalized AI-client ช่องทาง, tool name, status, ระยะเวลา, credential type, account/site, and timestamp. It does not store prompts, tool arguments, model tokens, raw user agents, raw result rows, or full error-ข้อความ bodies.

หลังติดตั้ง

What AI assistants can do with Hitsteps

Ask for ทราฟฟิก overviews, แหล่งที่มา breakdowns, top pages, แคมเปญ, เรียลไทม์ ผู้เยี่ยมชม, การติดตาม health, and executive digests from current Hitsteps data.
Work with Hitsteps-native operations such as website การตั้งค่า, เป้าหมาย, ทริกเกอร์ (called ป้ายกำกับผู้เยี่ยมชม in MCP), อัปไทม์ contacts and มอนิเตอร์, per-user การแจ้งเตือน, and authorized แชท เวิร์กโฟลว์.
Keep access bounded by OAuth scopes, account permissions, plan limits, confirmation prompts, and privacy-aware result shapes.