Skip to main content

Introduction

This guide shows how to add the JSONsilo MCP server to your AI tool. You need an MCP Key first.
The console builds these snippets for you. Right after you create a key, the MCP key created dialog shows them with your real key filled in. Later, click Connect a client on the MCP keys tab to see them again with a placeholder.

Connection Details

In every example below, replace jsmcp_YOUR_KEY with one of your MCP keys.

Setup

Run this in your terminal:
Terminal
Add --scope user to make the server available in every project.
These snippets contain your key. Keep them out of files you commit.

Check the Connection

Ask your assistant:
The assistant should call the 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
A working key returns 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 key is Read only. Write tools are hidden from the assistant with this kind of key. Create a new key with Read & write access.
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 silo is over 100 KB, so it is not returned whole. Ask the assistant for the specific part you need. See MCP Tools.
The MCP server is built for desktop and command-line clients. It doesn’t accept requests from web pages.