Skip to content

analyst-ng#12628 Add AI Assistants docs for the Inbox Tracker MCP server - #876

Merged
cadams500 merged 1 commit into
mainfrom
docs/inbox-tracker-mcp
Oct 12, 2026
Merged

cadams500 merged 1 commit into
mainfrom
docs/inbox-tracker-mcp

Conversation

@cadams500

@cadams500 cadams500 commented Oct 11, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Adds an AI Assistants category to the Analyst docs that explains how customers connect an AI assistant to the Inbox Tracker & Competitive Tracker MCP server (https://mcp.emailanalyst.com/mcp), what it can do, and how to troubleshoot a failed connection. Also changes the markdown renderer so one-click MCP install links work.

Refs SparkPost/analyst-ng#12628

Changes

  • content/analyst/ai-assistants/connect-an-ai-assistant.md (new): overview, which server to use (this one vs SparkPost MCP, plus a pointer to the Bird platform MCP docs), a Claude quick start, setup for Claude, Claude Code, ChatGPT, Cursor, VS Code with GitHub Copilot, Gemini CLI, Codex CLI and other clients (including mcp-remote), sign-in, access, and disconnecting.
  • content/analyst/ai-assistants/mcp-tools-and-prompts.md (new): all 33 tools grouped by product, each marked Reads or Changes with the subscription it needs, the built-in placement-drop prompt, and eight example prompts.
  • content/analyst/ai-assistants/mcp-troubleshooting.md (new): symptom, cause and fix tables for sign-in, tools and access, refreshing each client's tool list, and corporate proxies.
  • content/analyst/ai-assistants/index.md (new): category frontmatter.
  • components/site/analystHomePageContent.tsx: home-page card for the new category.
  • content/analyst/general/api-starter-guide.md: new section linking to the connect page.
  • components/markdown/index.tsx: transformLinkUri passes cursor:, vscode: and vscode-insiders: links through. Every other link still goes through react-markdown's default uriTransformer, which previously turned the install links into javascript:void(0).

Testing

  • npm run build (Node 16.18): exit 0. The two warnings it prints (SWC minify, no-explicit-any in components/site/status.tsx) are the same on main.
  • next start with a link check over the six affected pages: every page 200, every in-page anchor resolves, every internal and external link 200. Both install links render with their real cursor: and vscode: URLs.
  • All 25 JSON, TOML and shell snippets parse. The 33 tool names match the server source (mcp/packages/edatasource-tools, analyst-ng v6.16.51).
  • Against production: codex mcp add (Codex 0.162.1) and mcp-remote 0.14.3 signed in and connected. gemini mcp add (0.63.0) writes the config shown on the page.
  • No em or en dashes in new or changed lines.

Notes

  • Not yet tried by hand: sign-in from ChatGPT, Cursor, VS Code, Claude Code (its login needs an interactive terminal) and inside Gemini CLI, plus clicking the Cursor and VS Code install links.
  • ChatGPT plan limits are worded cautiously and link to OpenAI's help article, because that article couldn't be fetched to confirm the tiers.
  • "AI Assistants" sorts first in the sidebar because categories are ordered by folder name.

🤖 Generated with Claude Code


Note

Low Risk
Documentation and navigation updates plus a narrowly scoped markdown link allowlist for IDE MCP install schemes; no auth or API behavior changes.

Overview
Adds an AI Assistants docs section for connecting Claude, ChatGPT, Cursor, VS Code, and other clients to the Inbox Tracker & Competitive Tracker MCP server at https://mcp.emailanalyst.com/mcp. New pages cover setup and OAuth sign-in, all MCP tools with read vs change access, example prompts, and troubleshooting. The Analyst home page gets an AI Assistants card, and the API starter guide links to the connect flow as an alternative to API keys.

The shared markdown renderer now uses a custom transformLinkUri so Add to Cursor and Install in VS Code deep links (cursor:, vscode:, vscode-insiders:) are not stripped to javascript:void(0); other URLs still pass through react-markdown's default uriTransformer.

Reviewed by Cursor Bugbot for commit ad1e989. Bugbot is set up for automated code reviews on this repo. Configure here.

New content/analyst/ai-assistants category: connecting each supported
AI client to https://mcp.emailanalyst.com/mcp, the tool reference with
example prompts, and troubleshooting. Adds a home-page card and a
pointer from the API starter guide.

The markdown renderer now passes cursor: and vscode: links through, so
the one-click MCP install links render instead of javascript:void(0).

Refs SparkPost/analyst-ng#12628

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cadams500 cadams500 added the team - EA Email Analyst team is the subject matter expert and need to approve this PR label Oct 11, 2026
@netlify

netlify Bot commented Oct 11, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for support-docs ready!

Name Link
🔨 Latest commit ad1e989
🔍 Latest deploy log https://app.netlify.com/projects/support-docs/deploys/6acbd8862a091900081f727b
😎 Deploy Preview https://deploy-preview-876--support-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@cadams500
cadams500 merged commit e84127b into main Oct 12, 2026
6 of 7 checks passed
@cadams500
cadams500 deleted the docs/inbox-tracker-mcp branch October 12, 2026 15:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

👀 needs review team - EA Email Analyst team is the subject matter expert and need to approve this PR type: content change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant