Introduction
This guide shows how to add the JSONsilo MCP server to your AI tool. You need an MCP Key first.Connection Details
In every example below, replace
jsmcp_YOUR_KEY with one of your MCP keys.
Setup
- Claude Code
- Cursor
- VS Code
- Other
Run this in your terminal:Add
Terminal
--scope user to make the server available in every project.Check the Connection
Ask your assistant:list_silos tool and show your silos. If it does, you are connected.
You can also check from the terminal. This asks the server for its list of tools:
Terminal
200 with the tool list. A key that doesn’t work returns one of the errors below.
Troubleshooting
When a request is refused, the server answers with a status code and a JSON body such as{ "error": "Invalid MCP key" }.
The assistant can read silos but can't change them
The assistant can read silos but can't change them
The key is Read only. Write tools are hidden from the assistant with this kind of key. Create a new key with Read & write access.
A write fails with a schema error
A write fails with a schema error
The silo has a locked schema and the new data doesn’t match it. The error names the invalid value. Ask the assistant to fix the data, or change the schema in the console. See Schema Lock.
The assistant only gets a summary of my silo
The assistant only gets a summary of my silo
The silo is over 100 KB, so it is not returned whole. Ask the assistant for the specific part you need. See MCP Tools.
My browser-based tool can't connect
My browser-based tool can't connect
The MCP server is built for desktop and command-line clients. It doesn’t accept requests from web pages.