docs: path for mcp configuration is inconsistent (.opencode.jsonc and .opencode.json) #9248

Open
opened 2026-02-16 18:11:59 -05:00 by yindo · 2 comments
Owner

Originally created by @tcrasset on GitHub (Feb 13, 2026).

Originally assigned to: @jayair on GitHub.

Description

At https://opencode.ai/docs/mcp-servers/, sometimes it says the configuration is at .opencode.jsonc and sometimes it's at .opencode.json. Which one it is? Both?

Image Image

I know it says on https://opencode.ai/docs/config/ that both are allowed, but it's confusing for someone that's new and sees it switching between the sections

Plugins

No response

OpenCode version

No response

Steps to reproduce

No response

Screenshot and/or share link

No response

Operating System

No response

Terminal

No response

Originally created by @tcrasset on GitHub (Feb 13, 2026). Originally assigned to: @jayair on GitHub. ### Description At https://opencode.ai/docs/mcp-servers/, sometimes it says the configuration is at `.opencode.jsonc` and sometimes it's at `.opencode.json`. Which one it is? Both? <img width="229" height="164" alt="Image" src="https://github.com/user-attachments/assets/f1c292c3-2487-4ab3-b7bc-8c7e3936270e" /> <img width="217" height="157" alt="Image" src="https://github.com/user-attachments/assets/f8d0f079-2a83-47fa-ab1d-d11931777c66" /> I know it says on https://opencode.ai/docs/config/ that both are allowed, but it's confusing for someone that's new and sees it switching between the sections ### Plugins _No response_ ### OpenCode version _No response_ ### Steps to reproduce _No response_ ### Screenshot and/or share link _No response_ ### Operating System _No response_ ### Terminal _No response_
yindo added the bugdocs labels 2026-02-16 18:11:59 -05:00
Author
Owner

@itsrainingmani commented on GitHub (Feb 14, 2026):

When they show a config example that is some json with comments, they use the .jsonc extension since that is the "JSON with comments" format.

@itsrainingmani commented on GitHub (Feb 14, 2026): When they show a config example that is some json with comments, they use the `.jsonc` extension since that is the "JSON with comments" format.
Author
Owner

@ariane-emory commented on GitHub (Feb 14, 2026):

@tcrasset It's probably sensible to acclimate new users to the fact that they might see either (or even both, which is also completely legal) of these filenames being used for configuration files.

@ariane-emory commented on GitHub (Feb 14, 2026): @tcrasset It's probably sensible to acclimate new users to the fact that they might see either (or even _both_, which is also completely legal) of these filenames being used for configuration files.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#9248