This article is a machine translation of the contents of the following URL, which I wrote in Japanese:
https://qiita.com/Nana_777/items/c18aab73fec710c01b09
Introduction
In a previous article, I introduced how to directly access and use issues using a Backlog MCP server installed on a local PC.
In this article, I'll explain how to use a remote MCP server on the Internet.
The Kiro homepage has a feature that allows you to import MCP server settings with one click, so I'll use that to set things up.
[Previous Article]
https://qiita.com/Nana_777/items/c02aa5032aafd918d0a6
Local MCP Server
A local MCP server refers to an MCP server running in a local environment.
My previous Backlog MCP server also used an MCP server installed on my local PC from GitHub.
Therefore, the MCP configuration file referenced by Kiro contains a path to the local C: drive, as shown in
"args": ["C:...backlog-mcp-server\\build\\index.js"]
Local MCP Server Setup Procedure
- Obtain the MCP server code from GitHub or other sources using gitClone.
- Install by running "npm install" and "npm run build."
- Enter the settings (file paths and arguments) in mcp.json.
↓ Full Settings
{
"mcpServers": {
"backlog": {
"command": "node",
"args": ["C:...backlog-mcp-server\\build\\index.js"],
"env": {
"BACKLOG_DOMAIN": "YourBacklogUrl.backlog.com",
"BACKLOG_API_KEY": "APIKEY"
},
"disabled": false,
"autoApprove": []
}
}
}
Remote MCP Server
A remote MCP server is hosted on the Internet and can be used simply by entering the settings without having to install it on your local PC.
Therefore, the MCP configuration file referenced by Kiro specifies the name and version of the remote MCP server instead of a path on the local PC, as shown below:
"args": ["awslabs.aws-documentation-mcp-server@latest"]
Kiro's Remote MCP Server One-Click Setup
Kiro publishes a list of major trusted MCP servers on its documentation page.
You can easily set up an environment that uses a remote MCP server by selecting any MCP server from that page.
↓Kiro's Remote MCP Server Introduction Page
https://kiro.dev/docs/mcp/servers/
Remote MCP Server One-Click Setup Procedure
Initial State
Initially, no MCP servers other than the previous local backlog MCP server are configured.
From here, add the settings for your remote MCP server on the Kiro page.
↓Capture of Kiro's MCP settings confirmation screen
Step 1: Select an MCP Server on the Kiro Page
On the Kiro remote MCP server introduction page, click the "Add to Kiro" button for the MCP server of your choice.
For this post, select "AWS Documentation."
↓Screen capture of Kiro's MCP selection page
Step 2: Accept Kiro's Configuration Confirmation Request
After selecting your MCP server, Kiro will launch and a pop-up message will appear asking you to confirm the remote MCP server configuration.
Select "Enable."
↓Screen capture of the pop-up window confirming the remote MCP server settings
Step 3: Verify that the configuration file has been overwritten
The settings for the selected MCP server will be added to the MCP configuration file, so confirm them.
↓Added configuration file description
Caution! What to do if an error occurs
Normally, you can get the remote MCP server to work by adding settings to the MCP server configuration file and, depending on the MCP type, further configuring arguments.
In my environment, I encountered the following error, so I'll describe the solution.
*I asked Kiro how to resolve this issue, but for some reason, I couldn't find a correct answer.
(Kiro ultimately configured the AWS Knowledge MCP Server instead, and it worked.)
:::note warn
Errors that occurred in Windows environments
Failed to connect to MCP server "aws-docs": MCP error -32000: Connection closed
:::
↓Error Description: Connection error occurred
↓The list of configured MCP servers in Kiro also confirms that a connection to the MCP server is not possible.
Solution: Read the instructions on the official website. In this case, the problem was caused by a configuration format specific to Windows environments.
As you can see from the official page below, the "AWS Documentation MCP Server" I selected this time has a different Windows configuration file format than the one added by Kiro's one-click installation.
The AWS Documentation MCP Server will function by configuring the "Windows" configuration file on the official page.
↓Official AWS Documentation MCP Server page
https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server
↓Confirm that the MCP server configuration was successful.
Step 4: Verify Operation
Since I configured a remote MCP server to search AWS documentation, I'll verify its operation by sending the following text to Kiro.
The sentence reads, "Please refer to the documentation regarding S3 bucket naming rules. Please cite the source."
As a result, Kiro generated an answer using a remote MCP server.
↓Screen capture of Kiro generating an answer using a remote MCP server
Conclusion
This time, I tried one-click setup of a remote MCP server using Kiro.
Depending on the type of MCP server, it may truly be possible to set it up with one click, but as I did this time, you may need to make adjustments if settings that are not specific to your environment are added to the setup.
If the setup is not successful, please refer to the official website of the MCP you need.
Reference URL
Kiro: Introducing a Remote MCP Server
https://aws.amazon.com/jp/blogs/news/introducing-remote-mcp/
Previous Kiro-related Articles
[AWS] Trying out Kiro's popular features, including rule file application and implementation from architecture diagrams [KIRO]
https://qiita.com/Nana_777/items/37a11c9a2f0065158528
[AWS] How to use Kiro SPEC for team development (SPEC splitting, external implementation interrupts) [Kiro]
Top comments (0)