Skip to content

docs: add Stivio MCP server example - #57600

Open
wsmhj wants to merge 1 commit into
anomalyco:devfrom
wsmhj:dev
Open

wsmhj wants to merge 1 commit into
anomalyco:devfrom
wsmhj:dev

Conversation

@wsmhj

@wsmhj wsmhj commented Oct 21, 2026 •

Copy link
Copy Markdown

Issue for this PR

N/A — docs addition, no linked issue.

Type of change

  • Bug fix
  • New feature
  • Refactor / code improvement
  • Documentation

What does this PR do?

Adds a Stivio section to the MCP servers docs (packages/web/src/content/docs/mcp-servers.mdx). Stivio is a remote MCP server for image-to-video generation; the example shows the JSON config (Bearer auth) plus a sample prompt, following the same format as the other entries on the page.

How did you verify your code works?

Docs-only change. I verified the endpoint URL and docs link resolve, and checked the JSON snippet against the config format used elsewhere in this file. No code paths touched.

Screenshots / recordings

N/A — text-only docs change.

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

@github-actions github-actions Bot added the needs:compliance This means the issue will auto-close after 2 hours. label Oct 21, 2026
@github-actions

Copy link
Copy Markdown
Contributor

The following comment was made by an LLM, it may be inaccurate:

@opencode-agent opencode-agent Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a docs-only change, so there was nothing to run. I checked the example against the v2 config schema and the current docs on latest dev. The public API is unchanged.

The main problem is which docs it targets. The example goes into packages/web/src/content/docs/mcp-servers.mdx and uses the older config shape, with the server name directly under mcp. In v2, servers go under mcp.servers. The config schema (packages/schema/src/config/mcp.ts) only allows timeout and servers under mcp, so someone using v2 who copies this example won't get the server (see the inline comment).

The v2 MCP docs now live in services/www/src/docs/content/mcp-servers.mdx. That page has no section of third-party server examples, so whether to add vendor-specific examples there is a call for the maintainers.

{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"stivio": {

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In v2, servers go under mcp.servers (the config schema only allows timeout and servers under mcp), so this snippet won't set up the server for anyone on v2. It would need to look like "mcp": { "servers": { "stivio": { ... } } }. The v2 docs are in services/www/src/docs/content/mcp-servers.mdx, not this file.

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the review — good catch. The example targets the docs page as it exists on dev today, using the same config shape as the other entries there. If you'd like it moved to services/www/src/docs/content/mcp-servers.mdx with the v2 mcp.servers shape (or dropped, if vendor examples don't belong in the v2 docs), happy to do that — just say the word.

@github-actions github-actions Bot removed the needs:compliance This means the issue will auto-close after 2 hours. label Oct 21, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Thanks for updating your PR! It now meets our contributing guidelines. 👍

This branch has not been deployed

No deployments
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