Skip to content

feat(connectors): DataForSEO over stdio with vault creds; gate catches lost connector auth (v0.458.0) - #864

Merged
vikasprogrammer merged 1 commit into
mainfrom
feat/dataforseo-connector
Oct 12, 2026
Merged

vikasprogrammer merged 1 commit into
mainfrom
feat/dataforseo-connector

Conversation

@vikasprogrammer

Copy link
Copy Markdown
Owner

Why

DataForSEO "keeps disconnecting" on every tenant that uses it. Every DataForSEO connector pointed at the hosted mcp.dataforseo.com URL with no headers, so it authorized through an OAuth grant stored in Claude Code's own config dir. That grant expires, and it's absent on pooled runtime accounts. When it's missing, Claude Code replaces every tool with authenticate / complete_authentication stubs, which an unattended run can't complete. One tenant's transcripts hold 20 such stub calls. initech's composio-company has been failing the same way since 2026-09-08, and no admin was told.

What

  • Catalog: two new entries, DataForSEO (dataforseo-mcp-server@3.1.3) and DataForSEO (v2 tools) (@2.9.13). Both run over stdio with secret:DATAFORSEO_LOGIN / secret:DATAFORSEO_PASSWORD, so each call is plain Basic auth with nothing to expire. Versions are pinned because v2 → v3 renamed every tool.
  • npx pre-fetch: a cold npx install measured 21–35s, close to the MCP startup timeout. Enabled npx connectors are now fetched at boot and on add/enable (connector.warmed).
  • Gate: a call to any connector's OAuth stub is audited as connector.auth.lost and posts one admin card per connector per 6h with the fix. On an unattended run the call is also refused, with a reason the agent can act on.

Runbook: docs/connectors/dataforseo.md. Pinned by scripts/connector-auth-stub-test.cjs, which is added to test:governance.

Verified

  • npm run build, cd web && npm run build, and the full npm run test:governance all pass.
  • Both pinned server versions were probed over stdio: they list 4 and 89 tools respectively, and the v2 names match what live prompts reference.

🤖 Generated with Claude Code

…s lost connector auth (v0.458.0)

The hosted mcp.dataforseo.com URL authorizes with an OAuth grant held in
Claude Code's own config dir: it expires, is absent on pooled runtime
accounts, and when missing Claude Code swaps every tool for
authenticate/complete_authentication stubs an unattended run can't finish.

- Catalog: "DataForSEO" (dataforseo-mcp-server@3.1.3) and "DataForSEO (v2
  tools)" (@2.9.13), stdio, DATAFORSEO_LOGIN/PASSWORD from the vault.
  Pinned because v2->v3 renamed every tool.
- npx connectors are pre-fetched at boot and on add/enable (cold install
  measured 21-35s, near the MCP startup timeout).
- A call to any connector's OAuth stub is audited connector.auth.lost,
  cards the admins once per connector per 6h with the fix, and is refused
  on unattended runs with a reason the agent can act on.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vikasprogrammer
vikasprogrammer merged commit 44970f9 into main Oct 12, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant